Saltar al contenido
firmo
Docs / Introducción

Introducción

Qué es la API de Firmo, cómo se organiza y por dónde empezar.

La API de Firmo recibe los datos de una venta en JSON y se encarga del resto: valida, construye el XML del e-CF, lo firma con el certificado de tu empresa, lo envía a la DGII, consulta el resultado y te avisa por webhook. También recibe los e-CF que te mandan tus suplidores y guarda todo por 10 años.

Es una API REST con JSON, errores en español y nombres de campo que siguen la terminología de la DGII en camelCase (montoTotal, razonSocial, encf).

URL base#

Producción y sandbox
https://api.firmo.do/v1

El ambiente lo define tu API key, no la URL: sk_test_… trabaja en sandbox y sk_live_… en producción. Ver Autenticación y ambientes.

Primeros pasos#

  1. Crea una cuenta sandbox y guarda tu API key.
  2. Emite tu primer e-CF de prueba siguiendo el inicio rápido.
  3. Configura un webhook para enterarte de cada resultado.
  4. Cuando estés listo para producción, sube tu certificado digital, completa la certificación y registra tus secuencias.

Referencia interactiva

Esta guía explica cómo usar la API. La lista completa de rutas y esquemas, generada del contrato, está en api.firmo.do/docs y en openapi.json.

Contenido#