Saltar al contenido
Facturador

Tipos de comprobante

GET /api/catalogs/document-types

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Catálogo SUNAT 01: tipos de comprobante (factura, boleta, notas, guías, nota de venta).

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).

Formato de respuesta: estándar {success, data, message?} (registro único). Aquí data es la lista completa (sin paginación ni pagination): son catálogos cortos.

Activos e inactivos: por defecto solo devuelve los registros activos de la empresa (los que se ofrecen en los formularios del sistema). Envía all=1 para incluir también los inactivos; cada fila trae active para distinguirlos. Un código inactivo puede ser rechazado al registrar comprobantes: usa siempre los activos.

Parámetros de la URL (query):

Campo Tipo Obligatorio Descripción / valores permitidos
use string No sale = solo los de venta (01 factura, 03 boleta, 80 nota de venta); purchase = los que se registran en compras (01, 02, 03, 14, GU75, NE76).
all 0 / 1 No 1 = incluir inactivos.

Campos de cada fila de data:

Campo Tipo Obligatorio Descripción / valores permitidos
id string Sí Código a enviar en el campo correspondiente del comprobante / registro.
description string Sí Descripción para mostrar al usuario.
short string No Abreviatura (FT, BV, NC...).
active boolean Sí true si la empresa lo tiene activo.

Errores:

  • 401 sin token o con un token inválido.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
use query no sale sale (venta) o purchase (compras). Opcional.
all query no 1 1 = incluir también los registros inactivos (cada fila trae active). Por defecto solo activos.

Respuestas

{
  "success": true,
  "data": [
    {
      "id": "01",
      "description": "FACTURA ELECTRÓNICA",
      "short": "FT",
      "active": true
    },
    {
      "id": "03",
      "description": "BOLETA DE VENTA ELECTRÓNICA",
      "short": "BV",
      "active": true
    },
    {
      "id": "07",
      "description": "NOTA DE CRÉDITO",
      "short": "NC",
      "active": true
    },
    {
      "id": "08",
      "description": "NOTA DE DÉBITO",
      "short": "ND",
      "active": true
    },
    {
      "id": "09",
      "description": "GUIA DE REMISIÓN REMITENTE",
      "short": "GR",
      "active": true
    },
    {
      "id": "31",
      "description": "GUÍA DE REMISIÓN TRANSPORTISTA",
      "short": "GT",
      "active": true
    },
    {
      "id": "80",
      "description": "NOTA DE VENTA",
      "short": "NV",
      "active": true
    }
  ]
}

Pruébalo

Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.