Documentación / Otros servicios

Empresas y certificados

RECE.API es multi-empresa: podés operar varios CUIT desde la misma instalación, cada uno con su certificado por ambiente. Esta página cubre el alta de empresas y la gestión de certificados digitales.

Cómo se resuelve el certificado

En cada emisión, la API busca el certificado que corresponde a la combinación de CUIT + ambiente. El mismo CUIT puede tener dos certificados distintos, uno de homologación y otro de producción, y se elige según el campo ambiente del request.

Request con cuit + ambiente
      │
      ├─ 1. Certificado activo en la base de datos para ese CUIT y ambiente
      │
      └─ 2. Si no hay: archivo .pfx configurado en el servidor

Listar empresas

Devuelve las empresas definidas en la configuración del servidor.

[
  {
    "cuit": "30712345678",
    "razonSocial": "Mi Empresa SRL",
    "ambiente": "Homologacion",
    "activa": true,
    "tieneCertificado": true
  }
]

Una empresa puntual. Acepta ?ambiente=, por defecto homologacion. Devuelve 404 si no existe.

El CUIT que se usa cuando un request no especifica cuit.

Subir un certificado

El certificado se guarda en la base y queda activo para ese CUIT y ambiente.

Convertir el certificado a Base64

[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\certs\produccion.pfx"))

base64 -w 0 produccion.pfx

var bytes  = File.ReadAllBytes("produccion.pfx");
var base64 = Convert.ToBase64String(bytes);

Respuesta

{
  "ok": true,
  "id": 3,
  "message": "Certificado guardado correctamente en base de datos",
  "venceEn": "15/04/2027",
  "diasRestantes": 455,
  "advertencia": null
}

• Si el certificado vence en menos de 30 días, advertencia trae el aviso.
• Si ya venció, la respuesta es 400 y no se guarda.
• Si el archivo no contiene la clave privada, la carga falla: exportá el .pfx incluyéndola.

Listar certificados

[
  {
    "id": 3,
    "cuit": "30712345678",
    "ambiente": "produccion",
    "razonSocial": "Mi Empresa SRL",
    "esActivo": true,
    "creadoEn": "2026-01-15T12:00:00Z",
    "venceEn": "2027-04-15T00:00:00Z",
    "tamanoBytes": 4096,
    "diasHastaVencimiento": 455,
    "estadoVigencia": "VIGENTE"
  }
]

Diagnóstico de certificado

La consulta a hacer cuando una emisión falla por autenticación. Verifica que el certificado exista, tenga clave privada y esté vigente.

curl "https://api.tudominio.com/api/empresas/30712345678/certificado/diagnostico?ambiente=produccion" \
  -H "X-Api-Token: abc123XYZ..."

Devuelve 404 si no hay empresa para ese CUIT, y 500 si el certificado no se puede cargar.

Desactivar un certificado

{ "ok": true, "message": "Certificado desactivado" }

No borra el registro: lo marca como inactivo. Para renovar un certificado, subí el nuevo y desactivá el anterior; conviene además invalidar el caché de WSAA para que los tickets viejos no se sigan usando.

Empresas en base de datos

Aparte de las empresas de configuración, existe un registro de empresas en la base con parámetros adicionales de integración.

{
  "nombre": "Mi Empresa SRL",
  "cuit": "30712345678",
  "ambiente": "produccion",
  "color": "#0078D4",
  "activa": true,
  "dbTipo": "SQL",
  "dbConnectionString": "Server=192.168.1.1;Database=ERP;User Id=usuario;Password=...;",
  "dbPrefijoTablas": "IV_",
  "monitorHabilitado": true,
  "monitorIntervaloSegundos": 30,
  "monitorLoteTamano": 10,
  "monitorValidarNumeracion": true,
  "monitorModoDebug": false
}