stackin
Volver al blog
Productos

Emisión de NFe

La superficie de factura de producto de la API — misma cuenta, misma key, mismo dashboard que NFS-e.

La emisión de NF-e es una de las dos superficies de documento de stackin (la otra es NFS-e). Es accesible con la misma API key, misma base URL y mismo dashboard que todo lo demás — emitir una factura de servicio mañana no significa una integración nueva.

Como superficie de producto, la emisión de NF-e es una llamada: POST /invoices con document_type: "nfe". La respuesta vuelve de forma síncrona en cuanto el autorizador responde — emitida con clave de acceso, o rechazada con el motivo del propio autorizador — no hay un paso separado de polling para el caso común.

Cada documento cae en uno de tres estados — emitida, rechazada o cancelada — visible en el dashboard junto con el payload crudo enviado y la respuesta cruda del autorizador, lo cual importa cuando un rechazo necesita entregarse a quien se encarga del cumplimiento fiscal de la empresa, en lugar de depurarlo a ciegas.

La cuota se cuenta por emisión exitosa, no por intento — un envío rechazado (NCM incorrecto, campo obligatorio faltante) no consume volumen del plan, ya que nada fue realmente transmitido ni autorizado por SEFAZ.

El mismo endpoint, clave y forma de respuesta funcionan tanto en homologation como en production; lo único que cambia entre entornos es contra cuál de ellos se creó la API key, lo cual queda fijo durante toda la vida de esa clave.

Consulta la referencia de la API para el formato exacto de solicitud/respuesta, y Emitir NF-e para los campos fiscales que NF-e específicamente exige.