Emisión por lotes

Hasta 5.000 notas fiscales en una llamada, por JSON o con la planilla del panel, con resultado por línea. El mismo motor de la emisión individual y de la planilla. Envía siempre referencia en cada ítem: es lo que hace seguro reenviar el lote.

POST /v1/lotes  --202-->  validando
                              |
          ao_validar = emitir_validas          ao_validar = aguardar
                              |                       |
                              |               aguardando_emissao
                              |                       |
                              |          POST /v1/lotes/{id}/emissao
                              v                       v
                          processando  (as notas transmitindo)
                              |
                              v
                          concluido  --> webhook LOTE_EMISSAO_CONCLUIDO

Etapa	Ruta	Qué ocurre
Crear	POST /v1/lotes	Siempre 202. Una preparación con bloqueio es 412, y no se crea nada.
Seguir	GET /v1/lotes/{id}	status: validando, aguardando_emissao, processando, concluido o erro, y los conteos.
Resultado por línea	GET /v1/lotes/{id}/itens	Cada línea con el status de la nota fiscal, o com_erro_validacao, aguardando_emissao, ja_existente.
Emitir (con aguardar)	POST /v1/lotes/{id}/emissao	"todas" o una lista de líneas. Una sola vez.
Corregir y emitir de nuevo	POST /v1/lotes/{id}/reprocessamento	Solo líneas con error, rejeitada o falha_transmissao con dps_enviada: "nao".
Informe	GET /v1/lotes/{id}/relatorio	La planilla con el resultado de cada línea.

Límites: 5.000 ítems con la clave de producción, 100 con la de prueba. JSON de hasta 30 MB, planilla de hasta 20 MB. Un POST /v1/lotes cuenta como una llamada en el límite de solicitudes. Los ítems de lote entran en la cola detrás de las notas fiscales individuales.

No confundas validar con emitir. La validación se ejecuta siempre, justo después de crear el lote. Con emitir_validas (predeterminado), las líneas válidas se emiten enseguida. Con aguardar, no se emite nada hasta que llames a POST /v1/lotes/{id}/emissao.

Envía referencia en todo ítem: es lo que hace seguro enviar el lote de nuevo. Consulta Idempotencia.