Ir al contenido

Colección de Postman

La colección recorre los caminos de una integración contra TesteCF (el ambiente de pruebas de la DGII), con pruebas que dicen si cada paso salió bien. Envía comprobantes de verdad a TesteCF.

Carpeta Qué hace Qué esperar
0. Preparación Lee la empresa de tu API key y su secuencia del tipo 31, y calcula los e-NCF que usarán los pasos siguientes (en la consola, encfParaXml para el paso 5). 200
1. JSON sin e-NCF Envía una factura sin e-NCF: el servicio asigna el número de su tramo. Usa ?wait=sent. 202 con trackId (sentWait: Sent)
2. JSON con tu e-NCF Envía una factura con un e-NCF del tramo de tu sistema. Nunca se cambia. 202
3. e-NCF repetido El mismo e-NCF otra vez, con otra Idempotency-Key. No se emite nada. 409 invoice.encf_taken
4. e-NCF fuera de tu tramo Un e-NCF propio dentro del tramo del servicio. 422 encf.outside_client_range
5. XML firmado por tu sistema Sube un e-CF que tu sistema numeró y firmó, y luego el mismo XML otra vez. Postman no firma: firma antes el XML con tu sistema, con el e-NCF encfParaXml del paso 0, y elígelo en el campo xml de 5.1 y 5.2 («Select files»). 202, y 409 la segunda vez
6. e-NCF propio sin secuencia registrada Opcional (se omite si no llenas encfSinRegistrar y venceSinRegistrar en el entorno). Sin fechaVencimientoSecuencia y con ella. 422 sequence.expiry_required, y 202
7. Estado hasta Aceptado Consulta cada comprobante enviado hasta el resultado de la DGII, con el código de seguridad, la fecha de firma y la URL del QR. 200 con Accepted
8. tipoeCF como código El tipo como número (31) se acepta y la respuesta dice E31; un tipo que no existe (E99) no. 202, y 400
9. Consultas por TrackID y por e-NCF Busca el comprobante del paso 1 por su TrackID y por su e-NCF. 200 con el mismo detalle
  1. En Postman, Import y elige los dos archivos.
  2. Selecciona el entorno y llena:
    • apiKey: una API key restringida a tu empresa de pruebas (cópiala en Current value; es secreta).
    • companyId: el ID de la empresa de pruebas (botón «Copiar ID» en su ficha).
    • compradorRnc y compradorNombre: el comprador de las facturas de prueba. En TesteCF el RNC debe ser válido (un contribuyente registrado en la DGII); con uno inventado, la DGII rechaza la factura.
  3. Ejecuta las solicitudes en orden, o la colección completa con Run.

Antes de empezar, la empresa de pruebas necesita una secuencia de TesteCF del tipo 31 registrada en su ficha. En TesteCF el rango lo defines tú (por ejemplo, del 1 al 1,000,000); la DGII no lo autoriza. Para los pasos 2 a 4, la secuencia tiene que estar dividida en tramos. Ver Numeración.