Restofy Docs

Pedir factura a tu nombre

POST /api/site-checkout/set-order-invoice-recipient

Descripción

Guarda los datos fiscales del cliente para emitir la factura del pedido a su nombre.

Detalles

Registra a nombre de quién se emite la factura del pedido que el cliente arma desde el menú digital: nombre o razón social, tipo y número de documento, tipo de persona y, si aplica, régimen y correo. Si el cliente no pide factura a su nombre, el pedido se factura como consumidor final.

Permisos requeridos

public

Request

Nombre Tipo Requerido Reglas
slug string
min:1 max:63
orderUuid string
min:36 max:36
name string
min:2 max:150
documentTypeId int
min_value:1
documentNumber string
min:3 max:50
organizationTypeId int
min_value:1
taxRegimeId int No
min_value:1
fiscalAddress string No
max:300
email string No
max:150

Ejemplo de request

curl -X POST https://restofy.pro/api/site-checkout/set-order-invoice-recipient \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>" \
  -d '{
    "slug": "string",
    "orderUuid": "string",
    "name": "string",
    "documentTypeId": 1,
    "documentNumber": "string",
    "organizationTypeId": 1
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-09-08T16:35:34Z
HTTP 200

Request

{
    "slug": "restofy_test_sitedinerhistory_9491_1788885293_tenant",
    "orderUuid": "5eaf0b0a-cf14-4870-b2e3-477dade661bd",
    "name": "Comercializadora Ríos SAS",
    "documentTypeId": 1,
    "documentNumber": "***",
    "organizationTypeId": 5,
    "email": "***"
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "ok": true
    }
}