Certificación ante Hacienda
Para autorizarte como emisor, Hacienda exige que transmitas con éxito un mínimo de documentos en el ambiente de pruebas, dentro de los 2 meses de tu plazo. Open Factura los emite por ti:
| Prueba | Mínimo |
|---|---|
| Factura (01) | 90 |
| Comprobante de Crédito Fiscal (03) | 75 |
| Evento de invalidación | 5 |
| Evento de contingencia | 5 |
Son las obligatorias para todo emisor del Sistema de Transmisión. Si vas a emitir otros documentos, al terminar pulsa Certificar también los demás documentos: emite además las pruebas de Nota de Remisión (50), Nota de Crédito (50), Nota de Débito (25), Comprobante de Retención (50), Comprobante de Liquidación (75), Documento Contable de Liquidación (50), Factura de Exportación (90), Sujeto Excluido (25), Donación (25) y los eventos de retorno (5) y operaciones especiales (5). Así puedes solicitar la autorización de todo de una vez.
Antes de empezar
Sección titulada «Antes de empezar»- Las credenciales de pruebas de Hacienda cargadas (certificado y contraseña de API).
- Un cliente contribuyente (con NIT y NRC) que reciba los Créditos Fiscales de prueba.
- El responsable del emisor: Hacienda lo exige en los eventos de invalidación y contingencia. La página te lo pide si falta.
Cómo funciona
Sección titulada «Cómo funciona»- Ensayo. Emite una Factura, un Crédito Fiscal, una invalidación y un ciclo de contingencia. Si algo está mal, aparece aquí y no en el documento 60. El panel se pausa al terminar el ensayo para que compruebes el contador del Sitio Emisores DTE.
- Volumen. Emite el resto: hasta 90 Facturas y 75 Créditos Fiscales, y luego las invalidaciones y las contingencias que falten. Una Factura invalidada sigue contando, igual que en el contador de Hacienda.
- Si Hacienda rechaza una prueba, se detiene y te muestra el código y las observaciones del MH. No gasta más números de control. Corrige la causa y reanuda: continúa donde quedó.
- Al completar, entra al Sitio Emisores DTE, comprueba el contador y abre Solicitar Autorización.
Los Créditos Fiscales de prueba necesitan como receptor a otro contribuyente: Hacienda rechaza
los que van dirigidos a tu propia empresa ([receptor.nit] VALOR NO VALIDO). Crea en Clientes uno
con NIT, NRC, actividad económica y dirección, y elígelo antes de iniciar.
Abre Certificación y pulsa Iniciar. Puedes pausar y reanudar cuando quieras.
openfactura certificacion ejecutar # lo obligatorioopenfactura certificacion ejecutar --completo # todos los documentos y eventosopenfactura certificacion estadoejecutar sale con 0 al completar y con 1 si Hacienda rechazó una prueba o dejó de responder.
curl -X POST https://app.openfactura.co/api/v1/certificacion/iniciar \ -H "Authorization: Bearer $OPENFACTURA_API_KEY" \ -H "Content-Type: application/json" -d '{}'
# Repite mientras "estado" sea "en_curso":curl -X POST https://app.openfactura.co/api/v1/certificacion/avanzar \ -H "Authorization: Bearer $OPENFACTURA_API_KEY"La clave necesita dte:read, dte:emit y dte:invalidate.
Pide a tu agente: «certifícame ante Hacienda». Usa certificacion_avanzar hasta completar y te
muestra el rechazo si lo hay.
Para asistentes de IA: llms.txt ·llms-full.txt · cada página en Markdown añadiendo .md a su ruta.