Una comanda pot tenir una adreça danyada, metadades de línia absents, estat incorrecte o reemborsament local incomplet mentre l’historial de la passarel·la continua sent vàlid. Editar ID de transacció, totals o estats històrics per arreglar la pantalla pot destruir la traçabilitat necessària per a comptabilitat i disputes.
Tracta la passarel·la com a evidència independent. Fes una còpia de la base i documenta la correcció abans de tocar WooCommerce.
Defineix el camp danyat
Anota què falla, com es va detectar i quina font prova el valor correcte. Separa dades del client, càlculs, fets de pagament, moviments d’estoc i fulfilment.
Fonts possibles:
- transacció o reemborsament del proveïdor
- correus o exportacions originals
- càlcul fiscal i d'enviament
- registre de magatzem
- logs protegits
- correcció d'adreça confirmadaNo acceptis un correu no verificat per canviar dades sensibles de compte o entrega.
Conserva l’estat original
Fes backup i exporta una representació amb privacitat controlada. Registra ID, mode d’emmagatzematge, estat, totals i referències externes.
Restringeix l’accés i defineix la retenció perquè conté dades personals i comercials. Evita editar mentre arriben callbacks o sincronitzacions. Si cal, pausa només la integració implicada i documenta la finestra.
Concilia el pagament per separat
Al proveïdor, confirma captura, reemborsament, disputa i payout. Desa ID estables i imports, mai dades de targeta.
L’estat WooCommerce no prova el moviment financer i canviar-lo no mou diners. No iniciïs una altra captura o devolució per alinear la interfície. Si els totals discrepen, classifica impostos, enviament, moneda i devolucions parcials abans de tocar línies.
Utilitza el datastore actiu
Comprova si HPOS és autoritatiu. Carrega i actualitza amb les API perquè WooCommerce gestioni taules i cau correctes.
$order = wc_get_order( $order_id );
if ( ! $order ) {
throw new RuntimeException( 'La comanda no es pot carregar amb seguretat' );
}No escriguis directament a wp_posts, postmeta o taules HPOS. SQL brut pot deixar adreces, lookup i cau incoherents.
Separa correccions d’esdeveniments
Corregeix una errada d’adreça com a canvi administratiu actual amb nota privada. Registra un reemborsament extern completat com a reemborsament manual local vinculat al seu ID. Ajusta l’estoc amb una operació auditable.
No eliminis notes antigues, reutilitzis un ID per a un altre cobrament ni moguis estats per provocar efectes. Per a impostos o factures, segueix el procés comptable de rectificació.
Assaja sobre una còpia
Utilitza staging amb correu sortint, indexació, pagaments reals i fulfilment desactivats. Aplica el canvi compatible i confirma que la comanda carrega a administració, informes i integracions.
Revisa totals, arrodoniment, línies i permisos. Un script ha d’apuntar a ID explícits, validar precondicions i permetre simulació. Inclou una empremta del valor actual i atura’t si canvia durant el diagnòstic.
Aplica i verifica una comanda
Fes una còpia recent, executa la correcció mínima i afegeix una nota amb evidència, operador i hora. Neteja només la cau relacionada.
Torna a carregar mitjançant WooCommerce, confirma que les referències financeres no han canviat i que no s’han duplicat correus, estoc o preparació. Processa un lot acotat només després de revisar el primer cas.
Compara també l’abans i el després amb una llista de camps permesos. Qualsevol canvi inesperat en total, moneda, ID de transacció, estat de pagament o línies obliga a restaurar la còpia i revisar el procediment. Desa el resultat de la verificació amb el tiquet intern, no dins d’una nota pública per al client.
Evita que es repeteixi
Rastreja la font: escriptura fallida, extensió incompatible, importació, procés manual o migració HPOS. Afegeix validació i logs al punt responsable.
El manteniment recurrent ha de conciliar totals externs, integritat, inventari i tasques fallides. Una reparació fiable recupera l’operativa sense esborrar la història financera.