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:
- 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).
- Emitir:
POST /api/documents. Guardadata.idydata.external_id(el request lo hace solo endocument_idydocument_external_id). - Enviar y consultar: si quedó Registrado,
POST /api/documents/send(facturas) o el resumen diario (boletas, sección Resúmenes). Estado conPOST /api/documents/status,GET /api/documents/find/{id}o el listado con cursor. - Compartir: por correo (
document/email), WhatsApp (documents/send-document-to-whatsapp) o descargando el PDF (sección Descargas). - 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.