Saltar al contenido
Facturador

Comprobantes electrónicos: antes de empezar

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

Emisión y seguimiento de comprobantes electrónicos SUNAT: facturas (01), boletas (03), notas de crédito (07) y de débito (08). Flujo completo:

  1. Catálogos: Catálogos para cobrar una venta (series, condiciones, métodos y destinos de pago), Catálogos para las líneas de venta, Catálogos de detracción; clientes y productos con Buscar clientes/productos para vender (o con los endpoints de personas y productos de la API).
  2. Emitir: POST /api/documents. Guarda data.id y data.external_id (el request lo hace solo en document_id y document_external_id).
  3. Enviar y consultar: si quedó Registrado, POST /api/documents/send (facturas) o el resumen diario (boletas, sección Resúmenes). Estado con POST /api/documents/status, GET /api/documents/find/{id} o el listado con cursor.
  4. Compartir: por correo (document/email), WhatsApp (documents/send-document-to-whatsapp) o descargando el PDF (sección Descargas).
  5. Anular: facturas con comunicación de baja y boletas con resumen de anulación (sección Resúmenes), o con una nota de crédito.

Formato del cuerpo de emisión: las claves van en español (serie_documento, datos_del_cliente_o_receptor, totales...). La plataforma no recalcula importes.

Errores comunes: 400 {success: false, message} cuando el cuerpo no supera la validación previa; 500 {success: false, message} ante errores de SUNAT u otros. Estados (state_type_id): 01 registrado, 03 enviado, 05 aceptado, 07 observado, 09 rechazado, 11 anulado, 13 por anular.