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 |
Descarga
Sección titulada «Descarga»- En Postman, Import y elige los dos archivos.
- 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).compradorRncycompradorNombre: 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.
- 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.