Integraciones

API SUNAT: tres formas de conectar tu sistema a la facturación electrónica

Si vendes desde una web o un sistema propio, tarde o temprano alguien te dice «hay que conectarlo con la API de SUNAT». Hay tres maneras de hacerlo, y solo una tiene sentido para casi todos los negocios pequeños.

Esquema: tu sistema envía la venta, el proveedor firma el XML y SUNAT devuelve la constancia

Qué significa conectar tu sistema a SUNAT

Hoy, cada vez que vendes, alguien abre el portal de SUNAT y escribe la factura a mano. Conectar tu sistema significa que la venta registrada en tu web o tu sistema genera el comprobante sola, sin volver a escribir nada.

Por debajo, un comprobante electrónico es un archivo XML con un formato que fija SUNAT, firmado con un certificado digital. Alguien lo valida y devuelve una constancia de recepción, el CDR. Sin CDR, la factura no está aceptada.

Las tres formas de hacerlo

1. El portal de SUNAT, a mano

Es lo que casi todos hacen al empezar. Solo necesitas tu clave SOL. No tiene API: sirve mientras emites pocos comprobantes y alguien tiene tiempo de escribirlos.

2. Un proveedor de facturación electrónica con API

Tu sistema le envía los datos de la venta en un formato simple, casi siempre JSON. El proveedor arma el XML, lo firma, lo manda a validar, guarda la constancia y te devuelve el PDF, el XML y el CDR. Algunos validan a través de un OSE, que es un operador autorizado por SUNAT para validar en su nombre.

Es la ruta que conviene a casi todos los negocios pequeños y medianos. Pagas una tarifa al proveedor, pero no tienes que mantener certificados, formatos ni conexiones que cambian.

3. Directo a SUNAT, con sistema propio

Tu sistema arma y firma el XML, lo envía a los servicios de SUNAT y procesa la respuesta. Requiere homologar el sistema y mantenerlo al día cada vez que SUNAT cambia algo. Tiene sentido para empresas grandes con equipo técnico propio. Para una pyme es mucho trabajo para ahorrar una tarifa mensual.

Una aclaración sobre «apisunat»

Mucha gente busca «apisunat» pensando que es la API oficial. Es un servicio privado con ese nombre, como hay varios otros. SUNAT no vende una API de facturación para negocios pequeños: lo que existe son sus servicios técnicos de recepción y consulta, que usan los proveedores o los sistemas homologados. Elegir proveedor es elegir con quién vas a trabajar, no a SUNAT.

Cómo se ve la integración, paso a paso

  1. El cliente compra o aceptas una cotización.
  2. Tu sistema arma los datos: cliente, RUC o DNI, productos, montos, IGV.
  3. Los envía al proveedor por su API.
  4. El proveedor responde: aceptado, aceptado con observaciones o rechazado.
  5. Tu sistema guarda el PDF, el XML y el CDR junto a la venta, y le envía el PDF al cliente.

El paso que más se olvida es el cuarto. Si el comprobante sale rechazado y nadie lo ve, la venta queda sin factura válida y te enteras cuando el cliente reclama o cuando cierras el mes.

Qué probar antes de emitir en serio

Todos los proveedores serios tienen un ambiente de pruebas. Úsalo con casos reales, incluidos los raros:

  • Un RUC mal escrito. ¿Lo detecta tu sistema antes de enviar, o te enteras por el rechazo?
  • Una boleta a una persona sin DNI y una que sí lo requiere por el monto.
  • Una nota de crédito para anular una factura emitida por error.
  • El proveedor caído. ¿La venta queda pendiente y se reintenta, o se pierde?
  • Una venta con descuento y otra con varios productos, para revisar que el IGV cuadre al centavo.

Si alguno de esos casos no tiene respuesta clara, no está listo.

Qué preguntarle a un proveedor antes de firmar

  • ¿Cobra por comprobante, por plan mensual o por ambos?
  • ¿Tiene ambiente de pruebas y documentación de su API en español?
  • ¿Qué pasa con mis comprobantes si dejo de pagar o me cambio?
  • ¿Cómo me avisa de un rechazo?
  • ¿Soporta guías de remisión, si las necesito?

Cuándo no vale la pena integrarlo

Si emites diez comprobantes al mes, el portal te alcanza. Una integración se paga cuando el tiempo de escribir facturas, o los errores al escribirlas, ya te cuestan más que la tarifa del proveedor. Antes de eso, es una solución buscando un problema.

Preguntas frecuentes

¿Qué es la API de SUNAT para facturación electrónica?

Son los servicios técnicos por los que se envían y validan los comprobantes. Casi todos los negocios pequeños los usan a través de un proveedor de facturación con API, no directamente.

¿Necesito homologar mi sistema ante SUNAT?

Solo si te conectas directo con sistema propio. Si usas un proveedor que valida con un OSE, el proveedor se encarga de eso.

¿Qué es el CDR?

La constancia de recepción que confirma que el comprobante fue aceptado. Hay que guardarla junto al XML de cada factura o boleta.

¿Cuánto cuesta integrar mi web con la facturación electrónica?

Depende del proveedor y de tu sistema. Pagas la tarifa del proveedor más el desarrollo de la integración, que conmigo entra en web app o sistema, desde 1,200 USD.

¿Apisunat es la API oficial de SUNAT?

No. Es un servicio privado con ese nombre. Hay varios proveedores similares y conviene compararlos.

¿Y ahora?

Si esto te sirvió, conversemos.

Si quieres que tu web, tu cotizador o tu sistema emitan solos, lo conecto con el proveedor que elijas como parte de una web app o sistema, desde 1,200 USD a precio cerrado.

Escribir por WhatsApp → Ver opciones de contacto