Emisión de Factura Electrónica, Nota de Crédito, Nota de Débito o Exportación.

Autenticación:

• Requiere API Key válido.

Ambiente:

• QA: environment="2".
• Producción: environment="1".

Identificación del documento:

• POS (dPtoFacDF): exactamente 3 dígitos (000–999).
• Número fiscal (dNroDF): 10 dígitos con ceros a la izquierda; sin reinicio de secuencia.

Montos y cálculo:

• Valores como cadenas con 2 decimales ("100.00"); cálculo interno hasta 6 decimales.
• Redondeo por línea y totales en 2 decimales (half-up).
• Impuestos: type="01"=ITBMS; code mapea la tasa vigente; se valida contra el catálogo.

Sucursal (branch):

• Teléfono: 8 dígitos sin guiones.
• Si no existe, enviar branch{ code, address, coordinates, phone, location, email } para registrarla.

Receptor:

• Consumidor Final: type="02" (sin RUC/DV/ubicación).
• Contribuyente/Gobierno: type="01"/"03" con RUC, DV, address, location (PP-DD-CC).
• Gobierno (type="03"): items[].gns (CPBS abreviada) obligatorio.

Exportación:

• Si dest_country!="PA", incluir export_info{ incoterms, currency, exchange_rate, value }.
• Si currency="ZZZ", enviar currency_desc.

Notas de crédito/débito:

• Obligatorio document.referred{ fd_number | cufe, fd_date }.

Contingencia:

• Si issue_type=contingency, informar contingency_start (ISO-8601 con offset) y contingency_reason.

Catálogos DGI:

• items[].mu según catálogo oficial; validar CPBS/GNS cuando aplique.

Respuestas:

• 201 autorizado: rejected=false (incluye cufe, authorization_number, pdf_url, qr_code_data, document_number, process_date).
• 201 rechazado DGI: rejected=true con messages[]; puede incluir service_response y xml.
• 400 validación local: messages[] con field_name/path.