{"openapi":"3.1.0","info":{"title":"BusinessLink API v1","description":"API de facturacion electronica (e-CF) de BusinessLink para la DGII de Republica Dominicana.\n\n## Reglas\n1. **Solo desde un servidor.** La clave de API (`bl_test_...` o `bl_live_...`) va en\n   `Authorization: Bearer <clave>` y nunca en el codigo del navegador: /v1 rechaza llamadas\n   con `Origin` (403 `llamada_desde_navegador`). Use una funcion de backend (Supabase Edge\n   Functions, Base44 backend functions, una API route) y guarde la clave como secreto.\n2. **Idempotency-Key obligatorio al emitir.** Un valor unico por factura (p. ej. un UUID).\n   Si reintenta la misma factura, repita el MISMO valor: recibe la misma respuesta y nunca se\n   emiten dos comprobantes.\n3. **Empiece con una clave `bl_test_` (sandbox).** Nada llega a la DGII; los comprobantes no\n   tienen validez fiscal. `numero_factura_interna` = `SIMULAR-RECHAZO` o `SIMULAR-CONDICIONAL`\n   simula esos resultados. Con `bl_live_` el comprobante es real y se reporta a la DGII.\n4. **Tipos de e-CF:** 31 credito fiscal (el comprador tiene RNC y lo usa como gasto), 32 consumo\n   (consumidor final; NO es nota de credito), 33 nota de debito, 34 nota de credito (siempre con\n   `referencia` al e-NCF que modifica), 41 compras (a un proveedor informal; va `proveedor` y\n   `retencion` por linea), 43 gastos menores (sin comprador, lineas exentas), 44 regimenes\n   especiales (exento), 45 gubernamental, 46 exportaciones (ITBIS tasa 0; comprador puede ser\n   extranjero con `id_extranjero` y `pais`), 47 pagos al exterior (proveedor extranjero, exento,\n   ISR retenido en cada linea). Cualquier tipo puede ir en otra moneda: `moneda: \"USD\"` y los\n   precios en dolares; `tipo_cambio` opcional (por defecto, venta del Banco Central). Use `GET /v1/rnc/{rnc}` para validar al comprador y `GET /v1/rnc?q=`\n   para buscarlo por nombre.\n5. **Webhooks:** en vez de consultar el estado cada rato, registre `POST /v1/webhooks` con la URL https de\n   su backend. Recibira `ecf.aceptado`, `ecf.aceptado_condicional` o `ecf.rechazado` con\n   `datos.encf`, `datos.estado` y `datos.mensajes`. Verifique el header\n   `BL-Signature: t=<unix>,v1=<hex>` = HMAC-SHA256(secreto, `t + \".\" + cuerpo crudo`) y rechace\n   firmas de mas de 5 minutos. Responda 2xx en menos de 10 s; si no, se reintenta hasta ~2 dias.\n   El mismo `id` de evento puede llegar mas de una vez: ignore los repetidos.\n6. **Errores:** siempre `{\"error\": {\"codigo\", \"mensaje\", \"sugerencia\", \"campo\", \"detalles\", \"request_id\"}}`\n   en espanol. Lea `sugerencia` para corregir y reintentar.\n","version":"1.28.0"},"servers":[{"url":"https://api.businesslink.do"}],"paths":{"/v1/me":{"get":{"tags":["API v1"],"summary":"Empresa y permisos de la clave usada","description":"Sirve para probar la conexion: dice a que empresa pertenece la clave y que puede hacer.","operationId":"me_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"claveApi":[]}]}},"/v1/facturas":{"post":{"tags":["API v1"],"summary":"Emitir un comprobante fiscal electronico (e-CF)","description":"Envie la **factura simple** (lineas con cantidad, precio y tasa de ITBIS; BusinessLink calcula los totales) o `{\"documento\": {...}}` con el JSON completo de la DGII (como lo arma un ERP).\n\n**Idempotency-Key es obligatorio:** un valor unico por factura (p. ej. un UUID). Si reintenta, use el MISMO valor: recibira la misma respuesta y nunca se emitiran dos comprobantes.\n\nCon una clave `bl_test_` nada llega a la DGII (sandbox). Para simular resultados use `numero_factura_interna`: `SIMULAR-RECHAZO` o `SIMULAR-CONDICIONAL`.","operationId":"emitir_factura_v1_facturas_post","security":[{"claveApi":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":255},"description":"Unico por factura (p. ej. un UUID). Repita el MISMO valor al reintentar.","example":"0b6f1c2e-3c1d-4a5e-9f7a-2d4b8c9e1f00"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/FacturaSimple"},{"$ref":"#/components/schemas/DocumentoCompleto"}]},"examples":{"e31_credito_fiscal":{"summary":"E31 credito fiscal, a credito, con descuento","value":{"tipo_ecf":"31","comprador":{"rnc":"101000228","razon_social":"Cliente Ejemplo SRL","correo":"compras@cliente.do"},"lineas":[{"descripcion":"Consultoria","cantidad":2,"precio_unitario":1500,"itbis":"18","tipo":"servicio"},{"descripcion":"Libro","cantidad":1,"precio_unitario":800,"itbis":"exento","descuento":{"porcentaje":10}}],"tipo_pago":"credito","fecha_limite_pago":"2026-11-30"}},"e32_consumo":{"summary":"E32 consumidor final, precios con ITBIS incluido","value":{"tipo_ecf":"32","precios_incluyen_itbis":true,"lineas":[{"descripcion":"Cafe americano","cantidad":2,"precio_unitario":118,"itbis":"18"}]}},"e34_nota_credito":{"summary":"E34 nota de credito que corrige montos de una E31","value":{"tipo_ecf":"34","comprador":{"rnc":"101000228","razon_social":"Cliente Ejemplo SRL"},"referencia":{"encf":"E310000000123","fecha":"2026-10-01","codigo_modificacion":"3"},"lineas":[{"descripcion":"Devolucion parcial consultoria","cantidad":1,"precio_unitario":500,"itbis":"18","tipo":"servicio"}]}},"e41_compras":{"summary":"E41 compra a persona fisica: retiene 100% ITBIS y 10% ISR","value":{"tipo_ecf":"41","proveedor":{"rnc":"00100000001","razon_social":"Juan Perez"},"lineas":[{"descripcion":"Servicio de publicidad","cantidad":1,"precio_unitario":10000,"itbis":"18","tipo":"servicio","retencion":{"itbis_porcentaje":100,"isr_porcentaje":10}}]}},"e47_pagos_exterior":{"summary":"E47 pago a proveedor extranjero con ISR retenido","value":{"tipo_ecf":"47","proveedor":{"id_extranjero":"530123456","razon_social":"Cloud Services LLC"},"lineas":[{"descripcion":"Suscripcion de software","cantidad":1,"precio_unitario":3500,"itbis":"exento","tipo":"servicio","retencion":{"isr_porcentaje":27}}]}},"e46_exportacion_usd":{"summary":"E46 exportacion en USD (tasa del Banco Central si no se indica tipo_cambio)","value":{"tipo_ecf":"46","moneda":"USD","comprador":{"id_extranjero":"US-12-3456789","razon_social":"Acme Imports Inc","pais":"ESTADOS UNIDOS"},"lineas":[{"descripcion":"Cacao en grano (quintal)","cantidad":150,"precio_unitario":450,"itbis":"0","tipo":"bien"}]}},"sandbox_rechazo":{"summary":"Sandbox: simular un rechazo de la DGII","value":{"tipo_ecf":"32","numero_factura_interna":"SIMULAR-RECHAZO","lineas":[{"descripcion":"Prueba","cantidad":1,"precio_unitario":100,"itbis":"18"}]}}}}}},"responses":{"201":{"description":"Comprobante emitido (live: en_proceso hasta que responda la DGII).","headers":{"Idempotent-Replayed":{"description":"true si es la respuesta guardada de un reintento","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FacturaEmitida"}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Idempotency-Key reutilizada con otros datos, solicitud en proceso, sin secuencia disponible o e-NCF duplicado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/ecf":{"post":{"tags":["API v1"],"summary":"Emitir un e-CF con el JSON completo de la DGII (para ERPs)","description":"Para sistemas que ya calculan sus montos (Odoo, otros ERP): el cuerpo es el JSON del e-CF tal como lo arma el ERP (`Encabezado`, `DetallesItems`, `InformacionReferencia`, ... y `extra_fields` opcional). BusinessLink no recalcula nada: firma, valida contra el XSD y envia a la DGII, igual que `/fe/emision/api/jsonecf`.\n\n`RNCEmisor` debe ser el de la empresa de la clave. El e-NCF lo pone el ERP.\n\n**Idempotency-Key es obligatorio.** Reintente con el MISMO valor tras un timeout: nunca se emiten dos comprobantes. Si cambia el documento, use otra clave.\n\nEl resultado de la DGII llega por webhook o con `GET /v1/facturas/{encf}` / `POST /v1/ecf/estados`. Para apps que no calculan impuestos use `POST /v1/facturas`.","operationId":"emitir_ecf_v1_ecf_post","security":[{"claveApi":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Cuerpo"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/ecf/estados":{"post":{"tags":["API v1"],"summary":"Estado de varios comprobantes emitidos","description":"Cuerpo: `{\"encfs\": [\"E310000000001\", ...]}` (maximo 500). Devuelve `resultados` (mismo formato que GET /v1/facturas/{encf}) y `no_encontrados`.","operationId":"estados_ecf_v1_ecf_estados_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Cuerpo"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"claveApi":[]}]}},"/v1/facturas/{encf}":{"get":{"tags":["API v1"],"summary":"Estado de un comprobante emitido","operationId":"consultar_factura_v1_facturas__encf__get","security":[{"claveApi":[]}],"parameters":[{"name":"encf","in":"path","required":true,"schema":{"type":"string","title":"Encf"}}],"responses":{"200":{"description":"Estado del comprobante","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EstadoFactura"}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe en el modo de esta clave","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/facturas/{encf}/pdf":{"get":{"tags":["API v1"],"summary":"PDF (representacion impresa) del comprobante","description":"En sandbox el PDF lleva el sello SIN VALIDEZ FISCAL.","operationId":"pdf_factura_v1_facturas__encf__pdf_get","security":[{"claveApi":[]}],"parameters":[{"name":"encf","in":"path","required":true,"schema":{"type":"string","title":"Encf"}}],"responses":{"200":{"description":"Archivo","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe en el modo de esta clave","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/facturas/{encf}/xml":{"get":{"tags":["API v1"],"summary":"XML firmado del comprobante","operationId":"xml_factura_v1_facturas__encf__xml_get","security":[{"claveApi":[]}],"parameters":[{"name":"encf","in":"path","required":true,"schema":{"type":"string","title":"Encf"}}],"responses":{"200":{"description":"Archivo","content":{"application/xml":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe en el modo de esta clave","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/tasas":{"get":{"tags":["API v1"],"summary":"Tasa de cambio del dolar y del euro (Banco Central)","description":"Tasas que publica el Banco Central cada dia laborable al cierre (compra y venta, 4 decimales). USD: tasa de referencia del mercado spot. EUR: sondeo de entidades financieras (transferencias); el Banco Central no publica tasa spot del euro. Sin `fecha`: el ultimo cierre publicado. Con `fecha` (AAAA-MM-DD): la tasa que rige ese dia, es decir el cierre del dia laborable anterior. `fuente` dice de donde sale. Cualquier clave valida puede consultarla.","operationId":"tasa_cambio_v1_tasas_get","security":[{"claveApi":[]}],"parameters":[{"name":"moneda","in":"query","required":false,"schema":{"type":"string","default":"USD","title":"Moneda"}},{"name":"fecha","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fecha"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/dgii/estado":{"get":{"tags":["API v1"],"summary":"Estado actual de los servicios de la DGII","description":"Lista de servicios de facturacion electronica de la DGII y si cada uno esta disponible. `datos` es la respuesta de la DGII tal cual. Se guarda 1 minuto. Cualquier clave valida puede consultarla.","operationId":"estado_dgii_v1_dgii_estado_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"claveApi":[]}]}},"/v1/dgii/ventanas-mantenimiento":{"get":{"tags":["API v1"],"summary":"Ventanas de mantenimiento de la DGII","description":"Dias en que la DGII da mantenimiento a sus servicios de facturacion electronica. `datos` es la respuesta de la DGII tal cual. Se guarda 1 hora. Cualquier clave valida puede consultarla.","operationId":"ventanas_mantenimiento_dgii_v1_dgii_ventanas_mantenimiento_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"claveApi":[]}]}},"/v1/dgii/en-mantenimiento":{"get":{"tags":["API v1"],"summary":"Si la DGII esta en ventana de mantenimiento","description":"Pregunta a la DGII si sus servicios estan en mantenimiento ahora. `ambiente`: `testecf`, `certecf` o `ecf`; sin indicarlo se usa el de la clave. `datos` es la respuesta de la DGII tal cual.","operationId":"en_mantenimiento_dgii_v1_dgii_en_mantenimiento_get","security":[{"claveApi":[]}],"parameters":[{"name":"ambiente","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ambiente"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/rnc":{"get":{"tags":["API v1"],"summary":"Buscar contribuyentes por nombre","description":"Busca en el directorio publico de la DGII por razon social o nombre comercial (minimo 3 letras, sin importar acentos). Solo empresas y personas con RNC de 9 digitos: las cedulas se consultan por numero exacto con GET /v1/rnc/{rnc}.","operationId":"buscar_rnc_v1_rnc_get","security":[{"claveApi":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"limite","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limite"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/rnc/{rnc}":{"get":{"tags":["API v1"],"summary":"Consultar un RNC o cedula","description":"Razon social, nombre comercial, actividad, estado (ACTIVO, SUSPENDIDO, DADO DE BAJA, ...) y regimen, segun los archivos publicos de la DGII (se actualizan a diario).","operationId":"consultar_rnc_v1_rnc__rnc__get","security":[{"claveApi":[]}],"parameters":[{"name":"rnc","in":"path","required":true,"schema":{"type":"string","title":"Rnc"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/recibidos":{"get":{"tags":["API v1"],"summary":"Comprobantes recibidos de proveedores","description":"Ordenados del mas reciente al mas antiguo. Filtre por `fecha_emision` con `desde`/`hasta` (AAAA-MM-DD), por momento de llegada a BusinessLink con `recibido_desde` (ISO 8601, p. ej. 2026-10-10T14:00:00-04:00: lo que usa un ERP para traer solo lo nuevo), (AAAA-MM-DD), por proveedor (`emisor_rnc`) o tipo (`tipo_ecf`). Pagine con `limite` (max 200) y `offset`; `siguiente_offset` es null en la ultima pagina. Las claves bl_test_ ven lo recibido en los ambientes de prueba de la DGII.","operationId":"listar_recibidos_v1_recibidos_get","security":[{"claveApi":[]}],"parameters":[{"name":"desde","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Desde"}},{"name":"hasta","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hasta"}},{"name":"emisor_rnc","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Emisor Rnc"}},{"name":"tipo_ecf","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tipo Ecf"}},{"name":"limite","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limite"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"recibido_desde","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recibido Desde"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/recibidos/{emisor_rnc}/{encf}":{"get":{"tags":["API v1"],"summary":"Un comprobante recibido, con el documento completo","description":"Ademas del resumen, `documento` trae la factura completa leida del XML firmado: lineas (codigos, cantidad, precio, descuento, ITBIS por linea, impuestos adicionales), descuentos o recargos globales, totales por tasa, moneda y referencias (orden de compra, pedido, NCF modificado). `documento.cuadre` indica si lineas + impuestos suman el total y si los montos de las lineas incluyen el ITBIS (muchos emisores lo declaran mal). Si no hay XML, `documento` es null y `documento_error` explica por que.","operationId":"recibido_v1_recibidos__emisor_rnc___encf__get","security":[{"claveApi":[]}],"parameters":[{"name":"emisor_rnc","in":"path","required":true,"schema":{"type":"string","title":"Emisor Rnc"}},{"name":"encf","in":"path","required":true,"schema":{"type":"string","title":"Encf"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/recibidos/{emisor_rnc}/{encf}/pdf":{"get":{"tags":["API v1"],"summary":"PDF de un comprobante recibido","operationId":"recibido_pdf_v1_recibidos__emisor_rnc___encf__pdf_get","security":[{"claveApi":[]}],"parameters":[{"name":"emisor_rnc","in":"path","required":true,"schema":{"type":"string","title":"Emisor Rnc"}},{"name":"encf","in":"path","required":true,"schema":{"type":"string","title":"Encf"}}],"responses":{"200":{"description":"Archivo","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe en el modo de esta clave","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/recibidos/{emisor_rnc}/{encf}/xml":{"get":{"tags":["API v1"],"summary":"XML firmado de un comprobante recibido","operationId":"recibido_xml_v1_recibidos__emisor_rnc___encf__xml_get","security":[{"claveApi":[]}],"parameters":[{"name":"emisor_rnc","in":"path","required":true,"schema":{"type":"string","title":"Emisor Rnc"}},{"name":"encf","in":"path","required":true,"schema":{"type":"string","title":"Encf"}}],"responses":{"200":{"description":"Archivo","content":{"application/xml":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe en el modo de esta clave","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/recibidos/leer":{"post":{"tags":["API v1"],"summary":"Leer un e-CF (XML) sin registrarlo","description":"Devuelve el `documento` completo (mismo formato que GET /recibidos/{emisor_rnc}/{encf}) de un XML de e-CF que su sistema ya tiene: arrastrado por un usuario, llegado por correo, o guardado antes. No guarda nada. `para_su_empresa` dice si el comprador del e-CF es su empresa y `firma` si la firma digital es valida (certificado tomado del XML).","operationId":"leer_recibido_v1_recibidos_leer_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeerXmlV1"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"claveApi":[]}]}},"/v1/webhooks":{"get":{"tags":["API v1"],"summary":"Webhooks registrados (sin el secreto)","operationId":"listar_webhooks_v1_webhooks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"claveApi":[]}]},"post":{"tags":["API v1"],"summary":"Registrar un webhook","description":"Recibira un POST firmado cuando la DGII responda por cada comprobante. Con una clave `bl_test_` el webhook recibe los eventos del sandbox. **El `secreto` solo se muestra ahora**: guardelo para verificar el header `BL-Signature` (`t=<unix>,v1=<HMAC-SHA256(secreto, t + '.' + cuerpo)>`) y rechace firmas de mas de 5 minutos.","operationId":"crear_webhook_v1_webhooks_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrearWebhookV1"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"claveApi":[]}]}},"/v1/webhooks/{webhook_id}":{"delete":{"tags":["API v1"],"summary":"Borrar un webhook (y su historial)","operationId":"borrar_webhook_v1_webhooks__webhook_id__delete","security":[{"claveApi":[]}],"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","title":"Webhook Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/webhooks/{webhook_id}/probar":{"post":{"tags":["API v1"],"summary":"Enviar un evento de prueba ahora","description":"Envia `webhook.prueba` firmado y devuelve lo que respondio su servidor.","operationId":"probar_webhook_v1_webhooks__webhook_id__probar_post","security":[{"claveApi":[]}],"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","title":"Webhook Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/webhooks/{webhook_id}/entregas":{"get":{"tags":["API v1"],"summary":"Historial de entregas (30 dias)","operationId":"entregas_webhook_v1_webhooks__webhook_id__entregas_get","security":[{"claveApi":[]}],"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","title":"Webhook Id"}},{"name":"limite","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limite"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/secuencias":{"get":{"tags":["API v1"],"summary":"Rangos de e-NCF registrados y numeros disponibles","operationId":"listar_secuencias_v1_secuencias_get","security":[{"claveApi":[]}],"parameters":[{"name":"tipo_ecf","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tipo Ecf"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["API v1"],"summary":"Registrar un rango que la DGII le autorizo","description":"Registre aqui los rangos que la DGII le aprobo en la Oficina Virtual (OFV).","operationId":"registrar_secuencia_v1_secuencias_post","security":[{"claveApi":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecuenciaV1"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/secuencias/{secuencia_id}/anular":{"post":{"tags":["API v1"],"summary":"Dejar de usar un rango","description":"No envia nada a la DGII: los numeros que no se usaron se anulan aparte (ANECF).","operationId":"anular_secuencia_v1_secuencias__secuencia_id__anular_post","security":[{"claveApi":[]}],"parameters":[{"name":"secuencia_id","in":"path","required":true,"schema":{"type":"string","title":"Secuencia Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnularSecuenciaV1"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Falta la clave, no existe, fue revocada o vencio (codigo clave_*).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Llamada desde un navegador o la clave no tiene el permiso necesario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos no validos: vea error.detalles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Demasiadas solicitudes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Error interno; use el request_id con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Servicio no disponible momentaneamente; reintente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"AnularSecuenciaV1":{"properties":{"confirmar":{"type":"boolean","title":"Confirmar","description":"Debe ser true. El rango deja de entregar numeros."}},"type":"object","required":["confirmar"],"title":"AnularSecuenciaV1"},"CrearWebhookV1":{"properties":{"url":{"type":"string","title":"Url","description":"https://... de su servidor o funcion; debe responder 2xx en menos de 10 s","examples":["https://miapp.com/api/webhooks/businesslink"]},"eventos":{"items":{"type":"string"},"type":"array","title":"Eventos","description":"Eventos a recibir: ecf.aceptado, ecf.aceptado_condicional, ecf.rechazado (o '*')."},"descripcion":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Descripcion"}},"type":"object","required":["url"],"title":"CrearWebhookV1"},"LeerXmlV1":{"properties":{"xml":{"type":"string","maxLength":8000000,"title":"Xml","description":"XML del e-CF en base64 (tal como lo envio el proveedor)."}},"type":"object","required":["xml"],"title":"LeerXmlV1"},"SecuenciaV1":{"properties":{"tipo_ecf":{"type":"string","title":"Tipo Ecf","description":"Tipo de e-CF: 31, 32, 33, 34, 41, 43, 44, 45, 46 o 47","examples":["31"]},"desde":{"type":"integer","title":"Desde","description":"Primer numero autorizado (1 = E310000000001)","examples":[1]},"hasta":{"type":"integer","title":"Hasta","description":"Ultimo numero autorizado","examples":[500]},"fecha_vencimiento":{"type":"string","title":"Fecha Vencimiento","description":"Vencimiento que dio la DGII, AAAA-MM-DD","examples":["2027-12-31"]},"siguiente":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Siguiente","description":"Primer numero a usar si parte del rango ya se uso"},"aviso_umbral":{"type":"integer","title":"Aviso Umbral","description":"Avisar cuando queden esta cantidad o menos","default":50}},"type":"object","required":["tipo_ecf","desde","hasta","fecha_vencimiento"],"title":"SecuenciaV1"},"Comprador":{"properties":{"rnc":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"RNC (9 digitos) o cedula (11). Obligatorio en E31 y en E32 desde RD$250,000","examples":["101000228"],"title":"Rnc"},"id_extranjero":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Comprador/proveedor del exterior (E44, E46, E47) en vez de rnc","title":"Id Extranjero"},"pais":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Solo E46 (exportaciones)","title":"Pais"},"razon_social":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Si se omite y el RNC esta en el directorio de la DGII, se completa sola","examples":["Cliente Ejemplo SRL"],"title":"Razon Social"},"correo":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Correo"},"direccion":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Direccion"},"contacto":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Contacto"}},"title":"Comprador","type":"object"},"Descuento":{"properties":{"porcentaje":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Descuento en %, 0 a 100","examples":[10],"title":"Porcentaje"},"monto":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Descuento en pesos (use porcentaje O monto)","examples":[150.0],"title":"Monto"}},"title":"Descuento","type":"object"},"Linea":{"properties":{"descripcion":{"description":"Producto o servicio","examples":["Consultoria"],"maxLength":80,"title":"Descripcion","type":"string"},"cantidad":{"description":"Hasta 2 decimales (limite de la DGII)","examples":[2],"exclusiveMinimum":0,"title":"Cantidad","type":"number"},"precio_unitario":{"description":"Precio por unidad, hasta 4 decimales","examples":[1500],"minimum":0,"title":"Precio Unitario","type":"number"},"itbis":{"default":"18","description":"Tasa de ITBIS de la linea","enum":["18","16","0","exento"],"title":"Itbis","type":"string"},"tipo":{"default":"bien","enum":["bien","servicio"],"title":"Tipo","type":"string"},"descuento":{"anyOf":[{"$ref":"#/components/schemas/Descuento"},{"type":"null"}],"default":null},"recargo_monto":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Recargo Monto"},"codigo":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Codigo interno del producto","title":"Codigo"},"unidad":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Codigo de unidad de medida de la DGII (p. ej. 43 = unidad)","title":"Unidad"},"retencion":{"anyOf":[{"$ref":"#/components/schemas/Retencion"},{"type":"null"}],"default":null}},"required":["descripcion","cantidad","precio_unitario"],"title":"Linea","type":"object"},"Referencia":{"properties":{"encf":{"description":"e-NCF (o NCF serie B) que se modifica","examples":["E310000000123"],"title":"Encf","type":"string"},"fecha":{"description":"Fecha del comprobante modificado, AAAA-MM-DD","title":"Fecha","type":"string"},"codigo_modificacion":{"description":"1 anula, 2 corrige texto, 3 corrige montos, 4 reemplazo por contingencia, 5 referencia a consumo","enum":["1","2","3","4","5"],"title":"Codigo Modificacion","type":"string"}},"required":["encf","fecha","codigo_modificacion"],"title":"Referencia","type":"object"},"Retencion":{"description":"Solo E41 (ITBIS y/o ISR) y E47 (ISR obligatorio). Porcentaje o monto.","properties":{"itbis_porcentaje":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"% del ITBIS de la linea retenido (p. ej. 100 o 30)","title":"Itbis Porcentaje"},"itbis_monto":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Itbis Monto"},"isr_porcentaje":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"% del monto de la linea (p. ej. 10; 27 en pagos al exterior)","title":"Isr Porcentaje"},"isr_monto":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Isr Monto"}},"title":"Retencion","type":"object"},"FacturaSimple":{"description":"BusinessLink calcula los totales y el ITBIS y, si su empresa usa numeracion de BusinessLink, asigna el e-NCF.","properties":{"tipo_ecf":{"enum":["31","32","33","34","41","43","44","45","46","47"],"title":"Tipo Ecf","type":"string"},"moneda":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"DOP","description":"DOP (por defecto) o USD, EUR, CAD, GBP, ... Con otra moneda, los precios, descuentos, recargos y retenciones en monto van en esa moneda; el e-CF se arma en pesos con el bloque OtraMoneda de la DGII.","examples":["USD"],"title":"Moneda"},"tipo_cambio":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Pesos por unidad de la moneda (hasta 4 decimales). Si se omite con USD, se usa la venta del Banco Central del cierre anterior a la fecha de emision (GET /v1/tasas). Para otras monedas es obligatorio.","examples":[61.6732],"title":"Tipo Cambio"},"comprador":{"anyOf":[{"$ref":"#/components/schemas/Comprador"},{"type":"null"}],"default":null},"proveedor":{"anyOf":[{"$ref":"#/components/schemas/Comprador"},{"type":"null"}],"default":null,"description":"E41/E47: a quien se le compra (igual que comprador)"},"lineas":{"items":{"$ref":"#/components/schemas/Linea"},"maxItems":1000,"minItems":1,"title":"Lineas","type":"array"},"precios_incluyen_itbis":{"default":false,"description":"true si precio_unitario ya trae el ITBIS","title":"Precios Incluyen Itbis","type":"boolean"},"tipo_pago":{"default":"contado","enum":["contado","credito"],"title":"Tipo Pago","type":"string"},"fecha_limite_pago":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Obligatoria si tipo_pago = credito. AAAA-MM-DD","title":"Fecha Limite Pago"},"tipo_ingresos":{"default":"01","description":"01 = ingresos por operaciones","enum":["01","02","03","04","05","06"],"title":"Tipo Ingresos","type":"string"},"fecha_emision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"AAAA-MM-DD; por defecto hoy (hora de RD)","title":"Fecha Emision"},"referencia":{"anyOf":[{"$ref":"#/components/schemas/Referencia"},{"type":"null"}],"default":null,"description":"Solo en 33 y 34"},"numero_factura_interna":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Su numero interno","title":"Numero Factura Interna"},"encf":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Solo si su empresa numera desde su propio sistema (numeracion 'erp')","title":"Encf"},"fecha_vencimiento_secuencia":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Con 'encf' propio, salvo en E32/E34. AAAA-MM-DD","title":"Fecha Vencimiento Secuencia"}},"required":["tipo_ecf","lineas"],"title":"FacturaSimple","type":"object"},"DocumentoCompleto":{"description":"Para ERPs que ya arman el e-CF completo (mismo formato que /fe/emision/api/jsonecf), con su propio e-NCF.","properties":{"documento":{"additionalProperties":true,"description":"Encabezado (IdDoc, Emisor, Comprador, Totales), DetallesItems, ...","title":"Documento","type":"object"}},"required":["documento"],"title":"DocumentoCompleto","type":"object"},"Totales":{"properties":{"tipo_ecf":{"title":"Tipo Ecf","type":"string"},"encf":{"title":"Encf","type":"string"},"fecha_emision":{"title":"Fecha Emision","type":"string"},"monto_gravado":{"title":"Monto Gravado","type":"string"},"monto_exento":{"title":"Monto Exento","type":"string"},"itbis":{"title":"Itbis","type":"string"},"total":{"title":"Total","type":"string"}},"required":["tipo_ecf","encf","fecha_emision","monto_gravado","monto_exento","itbis","total"],"title":"Totales","type":"object"},"FacturaEmitida":{"properties":{"encf":{"examples":["E310000000001"],"title":"Encf","type":"string"},"tipo_ecf":{"title":"Tipo Ecf","type":"string"},"modo":{"enum":["test","live"],"title":"Modo","type":"string"},"estado":{"description":"live: en_proceso hasta que responda la DGII. test: resultado simulado","title":"Estado","type":"string"},"codigo_seguridad":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Codigo Seguridad"},"fecha_firma":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Fecha Firma"},"url_consulta_qr":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url Consulta Qr"},"totales":{"anyOf":[{"$ref":"#/components/schemas/Totales"},{"type":"null"}],"default":null},"avisos":{"default":[],"items":{"type":"string"},"title":"Avisos","type":"array"},"sin_validez_fiscal":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"true en sandbox","title":"Sin Validez Fiscal"},"consultar":{"examples":["/v1/facturas/E310000000001"],"title":"Consultar","type":"string"}},"required":["encf","tipo_ecf","modo","estado","consultar"],"title":"FacturaEmitida","type":"object"},"EstadoFactura":{"properties":{"encf":{"title":"Encf","type":"string"},"tipo_ecf":{"title":"Tipo Ecf","type":"string"},"modo":{"enum":["test","live"],"title":"Modo","type":"string"},"estado":{"description":"en_proceso, Aceptado, Aceptado Condicional o Rechazado","title":"Estado","type":"string"},"mensajes":{"anyOf":[{"items":{},"type":"array"},{"type":"string"},{"type":"null"}],"default":null,"title":"Mensajes"},"fecha_emision":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Fecha Emision"},"total":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Total"},"itbis":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Itbis"},"codigo_seguridad":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Codigo Seguridad"},"url_consulta_qr":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url Consulta Qr"}},"required":["encf","tipo_ecf","modo","estado"],"title":"EstadoFactura","type":"object"},"CuerpoError":{"properties":{"codigo":{"examples":["documento_invalido"],"title":"Codigo","type":"string"},"mensaje":{"examples":["Una factura de credito fiscal (E31) requiere el RNC o cedula del comprador."],"title":"Mensaje","type":"string"},"sugerencia":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"examples":["Si el cliente no tiene RNC, use tipo_ecf 32 (consumo)."],"title":"Sugerencia"},"campo":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Campo"},"detalles":{"anyOf":[{"items":{"$ref":"#/components/schemas/DetalleError"},"type":"array"},{"type":"null"}],"default":null,"title":"Detalles"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Request Id"}},"required":["codigo","mensaje"],"title":"CuerpoError","type":"object"},"DetalleError":{"properties":{"campo":{"title":"Campo","type":"string"},"mensaje":{"title":"Mensaje","type":"string"},"sugerencia":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Sugerencia"}},"required":["campo","mensaje"],"title":"DetalleError","type":"object"},"Error":{"properties":{"error":{"$ref":"#/components/schemas/CuerpoError"}},"required":["error"],"title":"Error","type":"object"}},"securitySchemes":{"claveApi":{"type":"http","scheme":"bearer","description":"Clave de API bl_test_ (sandbox) o bl_live_ (produccion). Solo desde su servidor."}}},"security":[{"claveApi":[]}]}