Documentación de la API e-CF

cURL

curl -X POST https://api.ecf.synercore.do/v1/comprobantes \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Emisor-RNC: 130862346" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo": "31",
    "eNCF": "E310000000123",
    "fechaVencimientoSecuencia": "31-12-2026",
    "comprador": { "rnc": "131880681", "razonSocial": "CLIENTE SRL" },
    "items": [
      { "nombre": "Servicio de consultoría", "cantidad": 1, "precioUnitario": 10000, "itbis": 18 }
    ],
    "tipoPago": 1,
    "transmitir": true
  }'

Node.js

// Node.js 18+ (fetch nativo). No requiere dependencias externas.
const API_BASE = "https://api.ecf.synercore.do";
const API_KEY = process.env.ECF_API_KEY;
const EMISOR_RNC = "130862346"; // RNC del emisor por el que emites (tu cliente)

async function emitirComprobante() {
  const res = await fetch(`${API_BASE}/v1/comprobantes`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "X-Emisor-RNC": EMISOR_RNC,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      tipo: "31",
      eNCF: "E310000000123",
      fechaVencimientoSecuencia: "31-12-2026",
      comprador: { rnc: "131880681", razonSocial: "CLIENTE SRL" },
      items: [
        { nombre: "Servicio de consultoría", cantidad: 1, precioUnitario: 10000, itbis: 18 },
      ],
      tipoPago: 1,
      transmitir: true,
    }),
  });

  const json = await res.json();
  if (res.status >= 400 || !json.success) {
    throw new Error(json.error?.message ?? `HTTP ${res.status}`);
  }

  const { eNCF, estado, codigoSeguridad } = json.data;
  console.log("e-NCF:", eNCF, "| estado:", estado, "| código:", codigoSeguridad);
  return json.data;
}

emitirComprobante().catch((err) => console.error("Error:", err.message));

Python

# Python 3 — pip install requests
import os
import requests

API_BASE = "https://api.ecf.synercore.do"
API_KEY = os.environ["ECF_API_KEY"]

payload = {
    "tipo": "31",
    "eNCF": "E310000000123",
    "fechaVencimientoSecuencia": "31-12-2026",
    "comprador": {"rnc": "131880681", "razonSocial": "CLIENTE SRL"},
    "items": [
        {"nombre": "Servicio de consultoría", "cantidad": 1, "precioUnitario": 10000, "itbis": 18}
    ],
    "tipoPago": 1,
    "transmitir": True,
}

resp = requests.post(
    f"{API_BASE}/v1/comprobantes",
    json=payload,
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    },
    timeout=30,
)

body = resp.json()
if resp.status_code >= 400 or not body.get("success"):
    raise RuntimeError(body.get("error", {}).get("message", f"HTTP {resp.status_code}"))

data = body["data"]
print("e-NCF:", data["eNCF"], "| estado:", data["estado"], "| código:", data["codigoSeguridad"])

PHP

<?php
// PHP — composer require guzzlehttp/guzzle
require 'vendor/autoload.php';

use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;

$apiBase = 'https://api.ecf.synercore.do';
$apiKey = getenv('ECF_API_KEY');

$client = new Client(['base_uri' => $apiBase, 'http_errors' => false]);

$payload = [
    'tipo' => '31',
    'eNCF' => 'E310000000123',
    'fechaVencimientoSecuencia' => '31-12-2026',
    'comprador' => ['rnc' => '131880681', 'razonSocial' => 'CLIENTE SRL'],
    'items' => [
        ['nombre' => 'Servicio de consultoría', 'cantidad' => 1, 'precioUnitario' => 10000, 'itbis' => 18],
    ],
    'tipoPago' => 1,
    'transmitir' => true,
];

$response = $client->post('/v1/comprobantes', [
    'headers' => [
        'Authorization' => "Bearer {$apiKey}",
        'Content-Type'  => 'application/json',
    ],
    'json' => $payload,
]);

$status = $response->getStatusCode();
$body = json_decode((string) $response->getBody(), true);

if ($status >= 400 || empty($body['success'])) {
    throw new RuntimeException($body['error']['message'] ?? "HTTP {$status}");
}

$data = $body['data'];
printf("e-NCF: %s | estado: %s | código: %s\n", $data['eNCF'], $data['estado'], $data['codigoSeguridad']);

Java

// Java 11+ — java.net.http.HttpClient (sin dependencias externas).
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class EmitirComprobante {
    static final String API_BASE = "https://api.ecf.synercore.do";
    static final String API_KEY = System.getenv("ECF_API_KEY");

    public static void main(String[] args) throws Exception {
        String body = """
            {
              "tipo": "31",
              "eNCF": "E310000000123",
              "fechaVencimientoSecuencia": "31-12-2026",
              "comprador": { "rnc": "131880681", "razonSocial": "CLIENTE SRL" },
              "items": [
                { "nombre": "Servicio de consultoría", "cantidad": 1, "precioUnitario": 10000, "itbis": 18 }
              ],
              "tipoPago": 1,
              "transmitir": true
            }
            """;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(API_BASE + "/v1/comprobantes"))
            .header("Authorization", "Bearer " + API_KEY)
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();

        HttpResponse<String> res = client.send(request, HttpResponse.BodyHandlers.ofString());

        if (res.statusCode() >= 400) {
            // En producción, parsea el JSON (Jackson/Gson) y lee error.message.
            throw new RuntimeException("Error HTTP " + res.statusCode() + ": " + res.body());
        }

        // res.body() contiene { success, data: { eNCF, estado, codigoSeguridad, ... } }
        System.out.println("Respuesta: " + res.body());
    }
}

C# / .NET

// .NET 6+ — HttpClient + System.Text.Json
using System;
using System.Net.Http;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;

class Program
{
    const string ApiBase = "https://api.ecf.synercore.do";

    static async Task Main()
    {
        var apiKey = Environment.GetEnvironmentVariable("ECF_API_KEY");

        var payload = new
        {
            tipo = "31",
            eNCF = "E310000000123",
            fechaVencimientoSecuencia = "31-12-2026",
            comprador = new { rnc = "131880681", razonSocial = "CLIENTE SRL" },
            items = new[]
            {
                new { nombre = "Servicio de consultoría", cantidad = 1, precioUnitario = 10000, itbis = 18 }
            },
            tipoPago = 1,
            transmitir = true
        };

        using var http = new HttpClient();
        http.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}");

        var json = JsonSerializer.Serialize(payload);
        var content = new StringContent(json, Encoding.UTF8, "application/json");

        var res = await http.PostAsync($"{ApiBase}/v1/comprobantes", content);
        var bodyText = await res.Content.ReadAsStringAsync();
        using var doc = JsonDocument.Parse(bodyText);
        var root = doc.RootElement;

        if ((int)res.StatusCode >= 400 || !root.GetProperty("success").GetBoolean())
        {
            var msg = root.GetProperty("error").GetProperty("message").GetString();
            throw new Exception(msg ?? $"HTTP {(int)res.StatusCode}");
        }

        var data = root.GetProperty("data");
        Console.WriteLine($"e-NCF: {data.GetProperty("eNCF").GetString()} | " +
                          $"estado: {data.GetProperty("estado").GetString()} | " +
                          $"código: {data.GetProperty("codigoSeguridad").GetString()}");
    }
}