Modificar facturas con Zuzendu

Corrige datos de una factura TicketBAI ya procesada sin modificar su importe total.

Zuzendu permite corregir datos de una factura que TicketBAI ya ha procesado correctamente sin tener que anularla.

Cuándo utilizar Zuzendu

Utiliza este servicio para modificaciones correctivas que no cambien el precio final de la factura. Los casos habituales son:

• corregir datos del emisor o del destinatario;
• corregir la descripción u otros datos de los conceptos sin alterar el total.

Si la modificación cambia el importe total, debes emitir una factura rectificativa en lugar de utilizar Zuzendu.

Funcionamiento

1. Localiza el identificador id de la factura original. Puedes obtenerlo al enviarla o mediante los endpoints de consulta de facturas.
2. Envía al endpoint Modificar una factura mediante Zuzendu la estructura fiscal completa con los datos corregidos.
3. Mantén total_amount exactamente igual al de la factura original.
4. KubiBAI genera y envía la solicitud Zuzendu de forma síncrona y devuelve la respuesta de la hacienda foral.

El cuerpo utiliza una estructura reducida basada en la de Enviar una factura. No admite async_mode, webhook_url ni los campos exclusivos de FacturaE.

Cuando el intermediario está registrado como Software Garante, debe incluir guarantor_software_data para que KubiBAI pueda utilizar su certificado. En el resto de casos, KubiBAI utiliza su propio certificado de Software Garante; la empresa emisora no tiene que configurar un certificado digital.

Consulta los campos, restricciones y respuestas en la Referencia API.

Interpretar la respuesta

La respuesta incluye, entre otros, estos campos:

• has_tbai_warnings: indica si la hacienda ha aceptado la solicitud con advertencias;
• tbai_post_response_message: recopila los mensajes de validación en texto plano;
• tbai_post_response_data: contiene la respuesta original de TicketBAI, normalmente en XML y sin codificar en Base64;
• zuzendu_xml_contents: contiene el XML Zuzendu enviado, codificado en Base64;
• request_id: identificador que puede utilizarse para trazabilidad y soporte.