Migrar de v1 a v2
En la v2 tu empresa y su RNC salen del token: ninguna ruta los lleva. Es el único cambio. El cuerpo de los comprobantes, las respuestas, los códigos de error, la autenticación y los límites son los mismos.
La v1 sigue funcionando sin cambios, pero está obsoleta: no recibirá novedades. Migra cuando puedas.
Rutas
| Operación | v1 (obsoleta) | v2 |
|---|---|---|
| Login | POST /api/v1/Auth/login | POST /api/v2/Auth/login |
| Validar | POST /api/v1/dgii-ecf/validate/{companyId} | POST /api/v2/dgii-ecf/validate |
| Emitir | POST /api/v1/dgii-ecf/send/{companyId} | POST /api/v2/dgii-ecf/send |
| Estado de un e-CF emitido | GET /api/v1/dgii-ecf/document-status/{rnc}/{encf} | GET /api/v2/dgii-ecf/document-status/{encf} |
| Estado de un e-CF recibido | GET /api/v1/dgii-ecf/external-status/{companyId}?… | GET /api/v2/dgii-ecf/external-status?… |
| Datos en el padrón | GET /api/v1/dgii-ecf/consult-rnc/{rnc} | GET /api/v2/dgii-ecf/consult-rnc |
Pasos
- Cambia
/api/v1/por/api/v2/en la URL base de tu integración. - Quita
companyId(o el0) y{rnc}de las rutas, según la tabla. - No hace falta pedir un token nuevo: los tokens sirven para las dos versiones.
- Pruébalo con
validateantes de emitir.
Lo que no cambia: el JSON del comprobante, la cabecera Authorization, X-Correlation-Id, waitForFinal, el sobre { codigo, mensaje, procesado, data } y los códigos de data.code.