Referencia de la API

Ejemplo de petición

POST /v1/comprobantes HTTP/1.1
Host: api.ecf.synercore.do
Authorization: Bearer <API_KEY>
X-Emisor-RNC: <RNC_EMISOR>
Content-Type: application/json

{
  "tipo": "31",
  "eNCF": "E310000000005",
  "fechaVencimientoSecuencia": "31-12-2026",
  "comprador": {
    "rnc": "131880681",
    "razonSocial": "CLIENTE SRL"
  },
  "items": [
    {
      "nombre": "Servicio de consultoría",
      "cantidad": 1,
      "precioUnitario": 10000
    }
  ],
  "transmitir": true
}

// X-Emisor-RNC: RNC del emisor por el que emites. OBLIGATORIO
// al usar una API key de INTEGRADOR (400 si falta); identifica
// a cuál de tus emisores pertenece este comprobante.
// eNCF: tu propia secuencia (modo producción). Omítelo
// para que el servicio lo genere (modo certificación).
// fechaVencimientoSecuencia es obligatoria en 31 (no en 32/34).
// itbis (18), tipoPago (1), fechaEmision (hoy), tipoIngresos
// ("01") e indicadorMontoGravado (0) usan valores por defecto.

{
  "tipo": "31",
  "comprador": { "rnc": "131880681", "razonSocial": "CLIENTE SRL" },
  "items": [
    {
      "nombre": "Whisky importado",
      "cantidad": 1,
      "precioUnitario": 2500,
      "impuestosAdicionales": [
        { "tipoImpuesto": "013" },
        { "tipoImpuesto": "030" }
      ]
    }
  ]
}

// 013 = ISC Específico Whisky (RD$/unidad)
// 030 = ISC AdValorem Whisky (% sobre la base)
// Máx. 2 impuestos adicionales por ítem. El servicio calcula
// el monto desde el catálogo y lo suma al MontoTotal.

{
  "tipo": "46",
  "comprador": { "razonSocial": "FOREIGN BUYER INC" },
  "items": [
    { "nombre": "Producto exportado", "cantidad": 1, "precioUnitario": 5900, "itbis": 0 }
  ],
  "moneda": { "tipo": "USD", "tipoCambio": 59.00 }
}

// El servicio emite el bloque OtraMoneda (cada monto =
// monto DOP / tipoCambio). Es solo representación: NO altera
// los Totales en DOP ni el MontoTotal.

Conciliación por lote (cierre contable)

POST /v1/comprobantes/estados
Authorization: Bearer <API_KEY>

{ "eNCF": ["E310000000001", "E310000000002", "E320000000007"] }

// Respuesta:
{
  "success": true,
  "data": {
    "solicitados": 3,
    "encontrados": 3,
    "noEncontrados": 0,
    "porEstadoDgii": { "ACEPTADO": 2, "EN_PROCESO": 1 },
    "items": [
      {
        "eNCF": "E310000000001",
        "encontrado": true,
        "estadoDgii": "ACEPTADO",
        "trackId": "5f8b...",
        "montoTotal": "17700.00",
        "mensajeDgii": null
      }
      // ...
    ]
  }
}

// Hasta 500 e-NCF por llamada. Un e-NCF inexistente
// se marca encontrado:false SIN tumbar el lote.