Factura electrónica desde tu sistema, con una sola llamada

curl https://ecf.nodiqtech.com/api/v1/estado \
  -H "Authorization: Bearer nq_test_xxxxxxxxxxxxxxxx"

$ch = curl_init('https://ecf.nodiqtech.com/api/v1/estado');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('NODIQ_CLAVE')],
    CURLOPT_RETURNTRANSFER => true,
]);
$estado = json_decode(curl_exec($ch), true);

const r = await fetch('https://ecf.nodiqtech.com/api/v1/estado', {
  headers: { Authorization: `Bearer ${process.env.NODIQ_CLAVE}` },
});
const estado = await r.json();

{
  "id": "01JBZ8Q3W6Y7N2K4R5T8V9X0AB",
  "encf": "E320000000001",
  "ambiente": "Simulado",
  "estado": "aceptado"
}

curl -X POST https://ecf.nodiqtech.com/api/v1/comprobantes \
  -H "Authorization: Bearer nq_test_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-1001" \
  -d @comprobante.json

# Repetir la misma petición devuelve el mismo
# comprobante (mismo id y mismo e-NCF).

{
  "error": {
    "codigo": "validacion",
    "mensaje": "Revisa los datos del comprobante.",
    "detalles": [
      { "campo": "comprador.rnc", "mensaje": "El RNC 131000000 no es válido." },
      { "campo": "lineas.0.precio", "mensaje": "El precio debe ser mayor que cero." }
    ]
  }
}

{
  "datos": [ { "id": "01JBZ8…", "encf": "E310000000149" } ],
  "paginacion": { "pagina": 1, "por_pagina": 25, "total": 134, "paginas": 6 }
}

curl -X POST https://ecf.nodiqtech.com/api/v1/comprobantes \
  -H "Authorization: Bearer nq_test_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-1001" \
  -d '{
    "tipo": 31,
    "comprador": {
      "rnc": "101010101",
      "razon_social": "Ferretería Ozama, SRL",
      "correo": "compras@ozama.com.do"
    },
    "tipo_pago": 2,
    "fecha_limite_pago": "2026-12-05",
    "lineas": [
      { "nombre": "Cemento gris 42.5 kg", "cantidad": 40,
        "precio": 545.00, "indicador": 1, "tipo": 1, "unidad": 43 },
      { "nombre": "Transporte", "cantidad": 1,
        "precio": 2500.00, "indicador": 1, "tipo": 2 }
    ],
    "referencia_externa": "PED-1001"
  }'

$cuerpo = [
    'tipo' => 31,
    'comprador' => [
        'rnc' => '101010101',
        'razon_social' => 'Ferretería Ozama, SRL',
        'correo' => 'compras@ozama.com.do',
    ],
    'tipo_pago' => 2,
    'fecha_limite_pago' => '2026-12-05',
    'lineas' => [
        ['nombre' => 'Cemento gris 42.5 kg', 'cantidad' => 40, 'precio' => 545.00,
         'indicador' => 1, 'tipo' => 1, 'unidad' => 43],
        ['nombre' => 'Transporte', 'cantidad' => 1, 'precio' => 2500.00,
         'indicador' => 1, 'tipo' => 2],
    ],
    'referencia_externa' => 'PED-1001',
];
$ch = curl_init('https://ecf.nodiqtech.com/api/v1/comprobantes');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('NODIQ_CLAVE'),
        'Content-Type: application/json',
        'Idempotency-Key: pedido-1001',
    ],
    CURLOPT_POSTFIELDS => json_encode($cuerpo),
]);
$r = json_decode(curl_exec($ch), true);
$http = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($http >= 400) {
    throw new RuntimeException($r['error']['mensaje']);
}
echo $r['encf'], ' ', $r['estado']; // E310000000149 aceptado

const r = await fetch('https://ecf.nodiqtech.com/api/v1/comprobantes', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.NODIQ_CLAVE}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'pedido-1001',
  },
  body: JSON.stringify({
    tipo: 31,
    comprador: {
      rnc: '101010101',
      razon_social: 'Ferretería Ozama, SRL',
      correo: 'compras@ozama.com.do',
    },
    tipo_pago: 2,
    fecha_limite_pago: '2026-12-05',
    lineas: [
      { nombre: 'Cemento gris 42.5 kg', cantidad: 40, precio: 545,
        indicador: 1, tipo: 1, unidad: 43 },
      { nombre: 'Transporte', cantidad: 1, precio: 2500,
        indicador: 1, tipo: 2 },
    ],
    referencia_externa: 'PED-1001',
  }),
});
const doc = await r.json();
if (!r.ok) throw new Error(doc.error.mensaje);
console.log(doc.encf, doc.estado); // E310000000149 aceptado

{
  "id": "01JBZ8Q3W6Y7N2K4R5T8V9X0AB",
  "encf": "E310000000149",
  "tipo": 31,
  "estado": "aceptado",
  "ambiente": "TesteCF",
  "fecha_emision": "2026-11-05",
  "comprador": { "rnc": "101010101", "razon_social": "Ferretería Ozama, SRL" },
  "moneda": "DOP",
  "totales": {
    "gravado": 24300.00, "exento": 0.00, "itbis": 4374.00,
    "total": 28674.00, "itbis_retenido": 0.00, "isr_retenido": 0.00
  },
  "codigo_seguridad": "a7Xk2P",
  "fecha_firma": "2026-11-05 10:42:18",
  "track_id": "4f3c9a1e-…",
  "mensajes_dgii": [],
  "url_pdf": "https://ecf.nodiqtech.com/c/9f2b…/pdf",
  "url_xml": "https://ecf.nodiqtech.com/c/9f2b…/xml",
  "url_publica": "https://ecf.nodiqtech.com/c/9f2b…",
  "url_qr": "https://ecf.dgii.gov.do/testecf/consultatimbre?…",
  "creado": "2026-11-05T10:42:17-04:00"
}

{
  "valido": true,
  "totales": {
    "gravado": 24300.00, "exento": 0.00, "itbis": 4374.00,
    "total": 28674.00, "itbis_retenido": 0.00, "isr_retenido": 0.00
  },
  "advertencias": []
}

curl "https://ecf.nodiqtech.com/api/v1/comprobantes?estado=rechazado&desde=2026-11-01&hasta=2026-11-30" \
  -H "Authorization: Bearer nq_test_…"

$q = http_build_query(['estado' => 'rechazado', 'desde' => '2026-11-01', 'hasta' => '2026-11-30']);
$ch = curl_init("https://ecf.nodiqtech.com/api/v1/comprobantes?$q");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('NODIQ_CLAVE')],
    CURLOPT_RETURNTRANSFER => true,
]);
$lista = json_decode(curl_exec($ch), true)['datos'];

const q = new URLSearchParams({ estado: 'rechazado', desde: '2026-11-01', hasta: '2026-11-30' });
const r = await fetch(`https://ecf.nodiqtech.com/api/v1/comprobantes?${q}`, {
  headers: { Authorization: `Bearer ${process.env.NODIQ_CLAVE}` },
});
const { datos, paginacion } = await r.json();

curl https://ecf.nodiqtech.com/api/v1/comprobantes/01JBZ8Q3W6Y7N2K4R5T8V9X0AB \
  -H "Authorization: Bearer nq_test_…"

curl https://ecf.nodiqtech.com/api/v1/comprobantes/01JBZ8Q3W6Y7N2K4R5T8V9X0AB/pdf \
  -H "Authorization: Bearer nq_test_…" \
  -o 101010101E310000000149.pdf

$ch = curl_init('https://ecf.nodiqtech.com/api/v1/comprobantes/' . $id . '/pdf');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('NODIQ_CLAVE')],
    CURLOPT_RETURNTRANSFER => true,
]);
file_put_contents('comprobante.pdf', curl_exec($ch));

import { writeFile } from 'node:fs/promises';
const r = await fetch(`https://ecf.nodiqtech.com/api/v1/comprobantes/${id}/pdf`, {
  headers: { Authorization: `Bearer ${process.env.NODIQ_CLAVE}` },
});
await writeFile('comprobante.pdf', Buffer.from(await r.arrayBuffer()));

curl -X POST https://ecf.nodiqtech.com/api/v1/comprobantes/01JBZ8Q3W6Y7N2K4R5T8V9X0AB/reenviar \
  -H "Authorization: Bearer nq_test_…"

curl -X POST https://ecf.nodiqtech.com/api/v1/comprobantes/01JBZ8Q3W6Y7N2K4R5T8V9X0AB/correo \
  -H "Authorization: Bearer nq_test_…" \
  -H "Content-Type: application/json" \
  -d '{"para": "compras@ozama.com.do"}'

{
  "tipo": 34,
  "comprador": { "rnc": "101010101", "razon_social": "Ferretería Ozama, SRL" },
  "tipo_pago": 1,
  "lineas": [
    { "nombre": "Devolución total", "cantidad": 1,
      "precio": 24300.00, "indicador": 1, "tipo": 1 }
  ],
  "referencia": {
    "encf": "E310000000149",
    "fecha": "2026-11-05",
    "codigo": 1,
    "razon": "Devolución de mercancía"
  }
}

curl "https://ecf.nodiqtech.com/api/v1/recibidos?aprobacion=pendiente" \
  -H "Authorization: Bearer nq_live_…"

{
  "id": 8812,
  "encf": "E310000004410",
  "tipo": 31,
  "emisor": { "rnc": "130000001", "razon_social": "Suplidora Caribe, SRL" },
  "fecha_emision": "2026-11-04",
  "totales": { "itbis": 1620.00, "total": 10620.00 },
  "aprobacion": "pendiente",
  "url_xml": "https://ecf.nodiqtech.com/api/v1/recibidos/8812?formato=xml",
  "recibido": "2026-11-04T16:21:09-04:00"
}

curl -X POST https://ecf.nodiqtech.com/api/v1/recibidos/8812/rechazar \
  -H "Authorization: Bearer nq_live_…" \
  -H "Content-Type: application/json" \
  -d '{"motivo": "La mercancía no fue entregada."}'

await fetch('https://ecf.nodiqtech.com/api/v1/recibidos/8812/rechazar', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.NODIQ_CLAVE}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ motivo: 'La mercancía no fue entregada.' }),
});

curl -X POST https://ecf.nodiqtech.com/api/v1/clientes \
  -H "Authorization: Bearer nq_test_…" \
  -H "Content-Type: application/json" \
  -d '{"rnc": "101010101", "correo": "compras@ozama.com.do"}'

{
  "datos": [
    { "tipo": 31, "desde": 1, "hasta": 5000, "siguiente": 150,
      "disponibles": 4851, "vence": "2027-12-31", "activa": true }
  ]
}

{
  "rnc": "101010101",
  "razon_social": "FERRETERIA OZAMA SRL",
  "nombre_comercial": "FERRETERIA OZAMA",
  "estado": "ACTIVO",
  "emisor_electronico": true
}

{
  "ok": true,
  "empresa": { "rnc": "131000001", "razon_social": "TU EMPRESA SRL" },
  "ambiente": "TesteCF",
  "dgii": "operativo"
}

POST /webhooks/nodiq HTTP/1.1
Content-Type: application/json
Nodiq-Evento: documento.aceptado
Nodiq-Entrega: 48213
Nodiq-Firma: t=1793896938,v1=5f1c0e…9ab2

{
  "id": "evt_01JBZ9A1C2D3E4F5G6H7J8K9LM",
  "evento": "documento.aceptado",
  "creado": "2026-11-05T10:42:19-04:00",
  "datos": {
    "id": "01JBZ8Q3W6Y7N2K4R5T8V9X0AB",
    "encf": "E310000000149",
    "estado": "aceptado",
    "referencia_externa": "PED-1001",
    "totales": { "itbis": 4374.00, "total": 28674.00 }
  }
}

$cuerpo = file_get_contents('php://input');
$firma = $_SERVER['HTTP_NODIQ_FIRMA'] ?? '';
$secreto = getenv('NODIQ_WEBHOOK_SECRETO');

parse_str(str_replace(',', '&', $firma), $p); // ['t' => …, 'v1' => …]
$esperada = hash_hmac('sha256', ($p['t'] ?? '') . '.' . $cuerpo, $secreto);

if (empty($p['v1']) || !hash_equals($esperada, $p['v1'])
    || abs(time() - (int) $p['t']) > 300) {
    http_response_code(400);
    exit('Firma inválida');
}

$evento = json_decode($cuerpo, true);
// Encola el trabajo y responde rápido.
http_response_code(200);

import crypto from 'node:crypto';
import express from 'express';

const app = express();
app.post('/webhooks/nodiq', express.raw({ type: 'application/json' }), (req, res) => {
  const p = Object.fromEntries(
    (req.get('Nodiq-Firma') || '').split(',').map((x) => x.split('=')),
  );
  const esperada = crypto
    .createHmac('sha256', process.env.NODIQ_WEBHOOK_SECRETO)
    .update(`${p.t}.${req.body}`)
    .digest('hex');
  const ok = p.v1 && p.v1.length === esperada.length &&
    crypto.timingSafeEqual(Buffer.from(p.v1), Buffer.from(esperada)) &&
    Math.abs(Date.now() / 1000 - Number(p.t)) <= 300;
  if (!ok) return res.status(400).send('Firma inválida');

  const evento = JSON.parse(req.body);
  res.sendStatus(200); // procesa después
});

Emisor externo ──► /fe/autenticacion/api/semilla
                ──► /fe/autenticacion/api/validacioncertificado  (token)
                ──► /fe/recepcion/api/ecf  (e-CF firmado)
                         │
                         ├─ valida firma y RNC del comprador
                         ├─ responde el acuse de recibo (ARECF)
                         └─ webhook recibido.nuevo  ──► tu sistema

Tu aprobación ──► POST /api/v1/recibidos/{id}/aprobar
                ──► ACECF al emisor y a la DGII