WooCommerce: del pedido pagado a la factura emitida

<?php
/**
 * Plugin Name: Cairos para WooCommerce
 */

define("CAIROS_BASE", "https://erp.cairos.es/api/v1");

function cairos_llamar($ruta, $cuerpo = null, $llave = null) {
    $cabeceras = [
        "Authorization" => "Bearer " . getenv("CAIROS_CLAVE"),
        "Content-Type"  => "application/json",
    ];
    if ($llave) {
        $cabeceras["Idempotency-Key"] = $llave;
    }

    $r = wp_remote_post(CAIROS_BASE . $ruta, [
        "headers" => $cabeceras,
        "body"    => $cuerpo ? wp_json_encode($cuerpo) : null,
        "timeout" => 20,
    ]);

    if (is_wp_error($r)) {
        throw new Exception($r->get_error_message());
    }

    $estado = wp_remote_retrieve_response_code($r);
    $datos  = json_decode(wp_remote_retrieve_body($r), true);

    if ($estado >= 400) {
        $codigo = $datos["error"]["codigo"] ?? "desconocido";
        throw new Exception("Cairos " . $estado . ": " . $codigo);
    }

    return $datos;
}

add_action("woocommerce_payment_complete", "cairos_facturar_pedido");

function cairos_facturar_pedido($id_pedido) {
    $pedido = wc_get_order($id_pedido);

    // 1 · Si ya lo facturamos, no hay nada que hacer. Esta línea
    //     vale más que todo el resto del fichero.
    if ($pedido->get_meta("_cairos_factura_id")) {
        return;
    }

    $llave = "wc-" . $id_pedido;

    try {
        // 2 · Contacto. El NIF sale del campo que añadiste al
        //     proceso de compra.
        $contacto = cairos_llamar("/contactos", [
            "nombre" => trim($pedido->get_billing_company()
                ?: $pedido->get_formatted_billing_full_name()),
            "nif"    => $pedido->get_meta("_billing_nif"),
            "email"  => $pedido->get_billing_email(),
            "tipo"   => "cliente",
        ], $llave . "-contacto");

        // 3 · Líneas. get_subtotal() es SIN impuestos, que es lo
        //     que espera la API. Si tu tienda enseña precios con
        //     IVA incluido, sigue siendo el campo correcto.
        $lineas = [];
        foreach ($pedido->get_items() as $item) {
            $cantidad = $item->get_quantity();
            $lineas[] = [
                "concepto" => $item->get_name(),
                "cantidad" => $cantidad,
                "precio"   => round($item->get_subtotal() / max(1, $cantidad), 2),
                "iva"      => 21,
            ];
        }

        // 4 · Borrador.
        $factura = cairos_llamar("/facturas", [
            "contacto_id" => $contacto["id"],
            "serie"       => "WEB",
            "fecha"       => $pedido->get_date_paid()->date("Y-m-d"),
            "lineas"      => $lineas,
        ], $llave);

        // 5 · Guardamos ANTES de emitir. Si algo falla después,
        //     al menos sabemos que este pedido ya tiene factura.
        $pedido->update_meta_data("_cairos_factura_id", $factura["id"]);
        $pedido->save();

        // 6 · Emitir: aquí es donde toma número de serie.
        $emitida = cairos_llamar(
            "/facturas/" . $factura["id"] . "/emitir",
            null,
            $llave . "-emitir"
        );

        // 7 · Y el cobro, que en una tienda ya ha ocurrido.
        cairos_llamar("/cobros", [
            "factura_id" => $factura["id"],
            "fecha"      => $pedido->get_date_paid()->date("Y-m-d"),
            "importe"    => (float) $pedido->get_total(),
            "medio"      => $pedido->get_payment_method_title(),
        ], $llave . "-cobro");

        $pedido->update_meta_data("_cairos_factura_numero", $emitida["numero"]);
        $pedido->add_order_note("Factura " . $emitida["numero"]);
        $pedido->save();

    } catch (Exception $e) {
        // Ni una excepción sin registrar: un fallo silencioso aquí
        // se descubre en el cierre del trimestre.
        $pedido->add_order_note("Cairos: " . $e->getMessage());
        error_log("Cairos: " . $e->getMessage());
    }
}