Emite e-CF desde tu propio sistema

Sin escribir la factura dos veces

Si tu sistema ya hace las facturas, no hace falta copiarlas a mano para sacar el e-CF. Con la Integración API, tu programador conecta ese sistema a Arithmetik Cloud y cada venta sale como comprobante electrónico: firmado, enviado a la DGII y con su e-NCF de vuelta en tu sistema.

Cómo se conecta

1. Crea un token. En Configuración › Integración API, un administrador de la empresa crea un token de sandbox. Se muestra una sola vez, así que se guarda como una contraseña.
2. Conecta tu sistema. Tu programador sigue la documentación de la API, que trae ejemplos y la especificación OpenAPI.
3. Prueba en el sandbox. Los comprobantes de prueba van al ambiente de pruebas de la DGII y no tienen valor fiscal.
4. Pasa a producción. Cuando todo funcione, creas un token de producción y cambias la URL base. Las peticiones son las mismas.

Lo que emite y lo que recibes

Por la API salen facturas de crédito fiscal y de consumo, notas de débito y de crédito, y comprobantes de compras, gastos menores, regímenes especiales y gubernamentales. Los de exportación, los que llevan ISC y las anulaciones se siguen haciendo desde la app.

• El e-NCF y el estado. Cada respuesta trae el e-NCF, el código de seguridad y el estado ante la DGII. Si la DGII todavía lo está procesando, tu sistema lo consulta después.
• XML, PDF y código QR. Enlaces al XML firmado, a la representación impresa con tu formato de impresión y al código QR de la DGII.
• Sin duplicados. Cada emisión lleva una clave de idempotencia: si tu sistema reintenta una venta, recibe el mismo comprobante y no se gasta otro e-NCF.
• Consultas. Buscar un RNC en el registro de la DGII, ver las secuencias de e-NCF disponibles y el uso del mes.

En la app, como cualquier factura

Lo que emites en producción por la API queda en Arithmetik Cloud junto a lo que facturas desde la app, con su PDF y su XML. Si el cliente es receptor electrónico, el e-CF aceptado le llega solo a su buzón. Si el cliente no está registrado, la app lo crea con su RNC. Las líneas van con su descripción y su precio, sin descontar inventario.

Sandbox y producción

• Sandbox, para todas las empresas. Con su propia URL y sus propios tokens. Va al ambiente de pruebas de la DGII, y los PDF salen marcados sin valor fiscal.
• Producción, con un paquete API. Para emitir con valor fiscal, la empresa tiene que estar en producción, con su certificado digital vigente y un paquete API. El paquete se solicita a Arithmetik.
• Aparte de tu plan. Lo que emites por la API cuenta en el paquete API, no en los comprobantes al mes de tu plan.

Tokens bajo control

• Solo administradores. Solo un administrador de la empresa crea y revoca tokens, y la revocación es inmediata.
• Se ven una sola vez. La app no guarda el token, solo su huella. Si se pierde, se revoca y se crea otro.
• Permisos y vencimiento. Cada token es de emisión y consulta o solo de consulta, y puede vencer a los 30, 90 o 365 días.
• Límites a la vista. Peticiones por minuto y e-CF por día y por mes, con el uso de hoy y del mes en la misma pantalla.

La documentación para programadores está en arithmetikcloud.app/desarrolladores, con la especificación OpenAPI y pruebas contra el sandbox. Para un paquete API, escríbenos a ddrullard@dclconsulting.com.do o llama al 849-916-4420.