Restofy Docs

Datos para facturar a tu nombre

POST /api/site-checkout/get-invoice-catalogs

Descripción

Devuelve las listas de tipos de documento, tipos de persona y regímenes para pedir factura.

Detalles

Entrega las opciones que el cliente necesita para pedir su factura a nombre propio desde el menú digital: tipos de documento, tipos de persona y regímenes tributarios. Son listas de referencia que no dependen del pedido.

Permisos requeridos

public

Request

Nombre Tipo Requerido Reglas
slug string
min:1 max:63

Ejemplo de request

curl -X POST https://restofy.pro/api/site-checkout/get-invoice-catalogs \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>" \
  -d '{
    "slug": "string"
}'

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"
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "documentTypes": [
            {
                "documentTypeId": 1,
                "code": "cc",
                "name": "Cédula de Ciudadanía"
            },
            {
                "documentTypeId": 2,
                "code": "ce",
                "name": "Cédula de Extranjería"
            },
            {
                "documentTypeId": 3,
                "code": "nit",
                "name": "NIT"
            },
            {
                "documentTypeId": 5,
                "code": "passport",
                "name": "Pasaporte"
            },
            {
                "documentTypeId": 6,
                "code": "pep",
                "name": "Permiso Especial de Permanencia"
            },
            {
                "documentTypeId": 7,
                "code": "ppt",
                "name": "Permiso por Protección Temporal"
            },
            {
                "documentTypeId": 4,
                "code": "ti",
                "name": "Tarjeta de Identidad"
            }
        ],
        "organizationTypes": [
            {
                "organizationTypeId": 5,
                "code": "co.sector.publico",
                "name": "Entidad del Sector Público"
            },
            {
                "organizationTypeId": 4,
                "code": "co.esal",
                "name": "Entidad Sin Ánimo de Lucro"
            },
            {
                "organizationTypeId": 3,
                "code": "co.gran.contribuyente",
                "name": "Gran Contribuyente"
            },
            {
                "organizationTypeId": 2,
                "code": "co.persona.juridica",
                "name": "Persona Jurídica"
            },
            {
                "organizationTypeId": 1,
                "code": "co.persona.natural",
                "name": "Persona Natural"
            }
        ],
        "taxRegimes": [
            {
                "taxRegimeId": 6,
                "code": "co.autorretenedor",
                "name": "Autorretenedor"
            },
            {
                "taxRegimeId": 4,
                "code": "co.gran.contribuyente",
                "name": "Gran Contribuyente"
            },
            {
                "taxRegimeId": 2,
                "code": "co.no.responsable.iva",
                "name": "No Responsable de IVA"
            },
            {
                "taxRegimeId": 5,
                "code": "co.regimen.especial",
                "name": "Régimen Especial"
            },
            {
                "taxRegimeId": 3,
                "code": "co.regimen.simple",
                "name": "Régimen Simple de Tributación"
            },
            {
                "taxRegimeId": 1,
                "code": "co.responsable.iva",
                "name": "Responsable de IVA"
            }
        ]
    }
}