Guías por comprobante

Cada guía trae el JSON mínimo que funciona, los campos que más se equivocan y lo que pasa con SUNAT después. Los ejemplos van contra el modo pruebas; en producción solo cambia la dirección y la clave.

Comprobante	Código SUNAT	Endpoint	Llega a SUNAT	Guía
Factura	01	POST /comprobantes	Envío directo	Factura
Boleta de venta	03	POST /comprobantes	Resumen diario	Boleta
Nota de crédito	07	POST /comprobantes	Como su comprobante	Notas de crédito y débito
Nota de débito	08	POST /comprobantes	Como su comprobante	Notas de crédito y débito
Comunicación de baja / resumen de anulación	RA / RC	POST /comprobantes/{id}/anular	Por ticket	Anular
Resumen diario	RC	Automático	Por ticket	Resumen diario
Guía de remisión remitente	09	POST /guias	API de guías de SUNAT, por ticket	Guías de remisión
Guía de remisión transportista	31	POST /guias	API de guías de SUNAT, por ticket	Guías de remisión
Comprobante de retención	20	POST /retenciones	Envío directo	Retención
Comprobante de percepción	40	POST /percepciones	Envío directo	Percepción
Liquidación de compra	04	POST /liquidaciones-compra	Envío directo	Liquidación de compra

Detracción, anticipos, exportación, operaciones gratuitas, impuesto a las bolsas (ICBPER) y ventas a crédito están en Casos especiales.

Antes de emitir

• Plan. Retenciones, percepciones y liquidaciones de compra vienen desde el Plan PRO, igual que en la web.
• Régimen y Ficha RUC. SUNAT no permite facturas a un contribuyente del Nuevo RUS (422 regimen_no_permite) y una empresa nueva no emite hasta verificar su Ficha RUC (422 ficha_ruc_pendiente).
• Series. Usa las de tu local (GET /establecimientos). Las series de factura empiezan con F, las de boleta con B y las de guía de remitente con T.
• Totales. Tú mandas los importes de cada línea y los totales: calcula con dos decimales y redondea al final de cada línea. Si no cuadran, SUNAT observa o rechaza el comprobante (por ejemplo, la observación 4287 por un precio unitario que no coincide con el cálculo).
• Idempotency-Key. Mándala en cada emisión: si reintentas con la misma, no se emite dos veces (cómo funciona).

Notas de venta y cotizaciones

No son comprobantes electrónicos (no van a SUNAT), pero se registran con el mismo JSON:

• POST /notas-venta: el JSON de los comprobantes sin codigo_tipo_documento, con una serie de notas de venta (NV01…) y, si quieres, origen de una cotización o un pedido. Para facturarla después: POST /comprobantes con "origen": {"tipo": "nota_venta", "id": 88}.
• POST /cotizaciones: el JSON de los comprobantes sin serie, con fecha_de_vencimiento, fecha_de_entrega y observaciones opcionales.

Las dos vienen desde el Plan PRO.