Guías
Los casos donde el resultado de una operación no es un simple «funcionó o no funcionó»: contingencia, reintentos, límites y los detalles de cada ruta que dan más dudas en la práctica.
Emitir un DTE
Cómo llamar a POST /v1/dte, qué llega firmado por dentro y las tres respuestas que puede recibir.
Leer →Preparar y firmar por separado
Por qué separar la reserva del correlativo de la firma, el prepareToken y sus 15 minutos, y qué pasa si el documento cambia entre las dos llamadas.
Leer →Consultar y listar, con cursor
La diferencia entre consultar un documento por su código y listar el libro de lo sellado, y por qué la paginación es por cursor y no por página.
Leer →Anular un documento sellado
Los tres tipos de anulación, por qué exige Idempotency-Key sin gastar correlativo, y qué contesta anular algo que ya estaba anulado.
Leer →Descargar el JSON y el PDF
Los bytes exactos que devuelve el área de retención, por qué siguen contestando pasada la hora, y qué diferencia el JSON archivado del PDF.
Leer →Idempotencia y reintentos
Qué protege Idempotency-Key, su alcance por llave, qué pasa al repetirla con el mismo cuerpo o con otro, y cuáles son los únicos errores donde reintentar es seguro.
Leer →Contingencia y resultados inciertos
Los tres finales de una emisión, y qué hacer con cada uno sin emitir dos veces.
Leer →Límites de uso
Las tres ventanas de cupo, cómo leerlas de las cabeceras, por qué se cuentan antes de trabajar y por qué consultar el estado no las gasta.
Leer →Almacenamiento y retención
Por qué un destino de almacenamiento es un requisito para emitir, qué es el área de retención de una hora, y por qué el cliente no guarda archivos todavía.
Leer →De pruebas a producción
Por qué la llave decide el ambiente, qué comprueba el servidor antes de dejar emitir en producción, y qué es exactamente lo único que cambia.
Leer →