La tentación, cuando se integra facturación digital en una tienda, es hacer que el pedido dependa del documento: si el API no confirma, no hay venta. Es una decisión defendible sobre el papel y desastrosa en producción.
El problema real
Un API fiscal puede tardar. Puede caerse. Puede devolver un error de catálogo por un producto mal configurado hace tres meses. Si cualquiera de esas cosas ocurre mientras un comprador tiene el dedo sobre «Finalizar compra», el coste no lo paga el API: lo paga la tienda.
Cómo se resolvió
El plugin se engancha a la creación del pedido, arma el payload y lo envía. Si la respuesta es correcta, el número de control, el PDF y el XML quedan asociados al pedido. Si no lo es, el error se escribe en el pedido como metadato y en el listado aparece el estado fiscal correspondiente. La compra se completa igual.
La consecuencia práctica es que la persona de administración tiene una bandeja de pedidos con incidencias fiscales, y puede reemitir desde el formulario manual. El comprador nunca se enteró de nada.