Catálogo

La API de Facturación permite obtener un catálogo de datos respecto a tributación de acuerdo con la entidad regulatoria.

Tipos de Documento Electrónico por País

GET /api/catalogue/{countryCode}/document_types
Host: invoice.tandia.io
Content-Type: application/json
Authorization: Bearer <token-de-api>

Path Params

• countryCode: Se debe especificar el país del cual se quiere obtener los tipos de documentos electrónicos, enviando código ISO del país (ej. PE para Perú).

Respuesta

Al realizar la solicitud GET, la API responderá con un estado 200 si la solicitud fue exitosa y devolverá la respuesta en formato JSON. A continuación, la estructura de la respuesta.

[
    {
        "name": "FACTURA",
        "value": "invoice"
    },
    {
        "name": "BOLETA",
        "value": "receipt"
    },
    {
        "name": "NOTA DE CREDITO",
        "value": "credit-note"
    },
    {
        "name": "NOTA DE DEBITO",
        "value": "debit-note"
    },
    {
        "name": "GUIA DE REMISION",
        "value": "despatch"
    }
]

Motivos de anulación para Nota de Crédito por País

GET /api/catalogue/{countryCode}/voided_codes
Host: invoice.tandia.io
Content-Type: application/json
Authorization: Bearer <token-de-api>

Path Params

• countryCode: Se debe especificar el país del cual se quiere obtener los tipos de documentos electrónicos, enviando código ISO del país (ej. PE para Perú).

Respuesta

Al realizar la solicitud, la API responderá con un estado 200 si la solicitud fue exitosa y devolverá la respuesta en formato JSON. A continuación, la estructura de la respuesta.

[
    {
        "code": "01",
        "description": "Anulación de la operación"
    },
    {
        "code": "02",
        "description": "Anulación por error en el RUC"
    },
    {
        "code": "03",
        "description": "Corrección por error en la descripción"
    },
    {
        "code": "04",
        "description": "Descuento global"
    },
    {
        "code": "05",
        "description": "Descuento por ítem"
    },
    {
        "code": "06",
        "description": "Devolución total"
    },
    {
        "code": "07",
        "description": "Devolución por ítem"
    },
    {
        "code": "08",
        "description": "Bonificación"
    },
    {
        "code": "09",
        "description": "Disminución en el valor"
    },
    {
        "code": "10",
        "description": "Otros Conceptos"
    },
    {
        "code": "11",
        "description": "Ajustes de operaciones de exportación"
    },
    {
        "code": "12",
        "description": "Ajustes afectos al IVAP"
    }
]

Métodos de Pago por País

GET /api/catalogue/{countryCode}/payment_methods
Host: invoice.tandia.io
Content-Type: application/json
Authorization: Bearer <token-de-api>

Path Params

• countryCode: Se debe especificar el país del cual se quiere obtener los tipos de métodos de pago, enviando código ISO del país (ej. PE para Perú).

Respuesta

Al realizar la solicitud, la API responderá con un estado 200 si la solicitud fue exitosa y devolverá la respuesta en formato JSON. A continuación, la estructura de la respuesta.

[
    {
        "name": "CONTADO",
        "value": "cash"
    },
    {
        "name": "CREDITO",
        "value": "credit"
    }
]

Monedas aceptadas por País

GET /api/catalogue/{countryCode}/accepted_currency
Host: invoice.tandia.io
Content-Type: application/json
Authorization: Bearer <token-de-api>

Path Params

• countryCode: Se debe especificar el país del cual se quiere obtener la lista de monedas aceptadas, enviando código ISO del país (ej. PE para Perú).

Respuesta

Al realizar la solicitud, la API responderá con un estado 200 si la solicitud fue exitosa y devolverá la respuesta en formato JSON. A continuación, la estructura de la respuesta.

[
    {
        "name": "SOLES",
        "value": "PEN"
    },
    {
        "name": "DOLARES AMERICANOS",
        "value": "USD"
    }
]

Tipos de Documento de cliente por País

GET /api/catalogue/{countryCode}/identity_documents
Host: invoice.tandia.io
Content-Type: application/json
Authorization: Bearer <token-de-api>

Path Params

• countryCode: Se debe especificar el país del cual se quiere obtener la lista de tipos de documento de cliente, enviando código ISO del país (ej. PE para Perú).

Respuesta

Al realizar la solicitud, la API responderá con un estado 200 si la solicitud fue exitosa y devolverá la respuesta en formato JSON. A continuación, la estructura de la respuesta.

[
    {
        "code": "1",
        "description": "DNI"
    },
    {
        "code": "4",
        "description": "Carnet de extranjería"
    },
    {
        "code": "6",
        "description": "Registro Único de contribuyentes"
    },
    {
        "code": "7",
        "description": "Pasaporte"
    },
    {
        "code": "A",
        "description": "Ced. Diplomática de identidad"
    },
    {
        "code": "B",
        "description": "Documento identidad país residencia-no.d"
    },
    {
        "code": "E",
        "description": "Tarjeta Andina de Migración"
    }
]

Códigos de Unidad de Medida por País

Unidades de medida (esenciales)

Trae las unidades de medida de uso general y esenciales en cualquier negocio.

GET /api/catalogue/{countryCode}/measure_units
Host: invoice.tandia.io
Content-Type: application/json
Authorization: Bearer <token-de-api>

Unidades de medida (lista completa)

Trae la lista completa de unidades de medida, de acuerdo a la entidad regulatoria del país seleccionado.

GET /api/catalogue/{countryCode}/measure_units_all
Host: invoice.tandia.io
Content-Type: application/json
Authorization: Bearer <token-de-api>

Path Params

• countryCode: Se debe especificar el país del cual se quiere obtener la lista unidades de medida, enviando código ISO del país (ej. PE para Perú).

Respuesta

Al realizar la solicitud, la API responderá con un estado 200 si la solicitud fue exitosa y devolverá la respuesta en formato JSON. A continuación, la estructura de la respuesta.

[
    {
        "code": "NIU",
        "description": "UNIDAD (BIENES)"
    },
    {
        "code": "ZZ",
        "description": "UNIDAD (SERVICIOS) "
    }
]