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 →Nota de remisión (04) y comprobante de retención (07)
Para qué sirve cada uno, quién puede emitirlos, cada campo con su razón, los códigos de retención, lo que se ignora y los errores que verá.
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 →Registrar un evento de retorno
Cómo devolver parte o todo lo que una factura sellada vendió, qué contesta la API cuando Hacienda no responde y por qué un documento con eventos de retorno ya no se puede anular.
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 →Facturas pendientes y reintento
Qué hacer cuando una emisión terminó sin saber si Hacienda selló el documento, cómo listar lo pendiente, cómo reintentar sin duplicar y qué significan 503, indice_pendiente y reserva_sin_asentar.
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 →La hora de referencia
Un servicio público y sin credenciales que devuelve la hora de Facta con cuatro marcas de tiempo, para calibrar el reloj de su equipo sin consultarlo en cada operación.
Leer →Almacenamiento y retención
Cómo funciona todo el almacenamiento, desde la retención de una hora, la copia temporal de Facta (30 días; 2 días solo cuando Facta mismo verifica una copia), los correos al dueño, el almacenamiento de emergencia y cómo informar que ya guardó el documento.
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 →