Saltar al contenido
firmo
Docs / Integradores

Integradores

Maneja muchas empresas desde una cuenta con el header Firmo-Company.

Si tienes un POS, un ERP o una app con muchos clientes, una sola cuenta de Firmo puede manejar varias empresas (varios RNC). Cada empresa tiene su certificado, sus secuencias y sus e-CF por separado.

Para actuar sobre una empresa concreta, manda su id en el header Firmo-Company. Sin el header, la API usa la empresa principal de la cuenta.

bash
curl -X POST https://api.firmo.do/v1/ecf \
  -H "Authorization: Bearer $FIRMO_API_KEY" \
  -H "Firmo-Company: 3d9a7c10-52e4-4b8f-a1c6-0e2f7b9d4a18" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 9f8e7d6c-5b4a-4392-8170-6f5e4d3c2b1a" \
  -d @factura.json

Funciona en todas las rutas: emitir, consultar, certificado, secuencias, recibidos, webhooks y certificación.

Crear y listar empresas#

POST/v1/companies

CampoDescripción
rncObligatorio. RNC (9 dígitos) o cédula (11), sin guiones.
razonSocialObligatorio.
nombreComercial, direccion, municipio, provincia, telefono, correo, sitioWeb, actividadEconomicaOpcionales.
bash
curl -X POST https://api.firmo.do/v1/companies \
  -H "Authorization: Bearer $FIRMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "rnc": "131000000", "razonSocial": "Farmacia San Rafael SRL", "correo": "admin@farmaciasanrafael.do" }'

GET /v1/companies lista todas las empresas de tu cuenta.

Flujo recomendado para dar de alta un cliente#

  1. Crea la empresa con POST /v1/companies y guarda su id.
  2. Sube su certificado con POST /v1/company/certificate y el header Firmo-Company.
  3. Completa su certificación y registra sus secuencias.
  4. Emite con el mismo header.
El plan Integrador incluye 10 RNC y 5,000 e-CF compartidos. Cada RNC extra cuesta RD$350 al mes. Ver Precios.