WooCommerce recalcula quan canvien el país, la província o el codi postal. Si desapareixen tots, l’adreça pot no coincidir amb cap zona, el paquet no ser elegible, l’API haver fallat o l’actualització no completar-se.
No afegeixis enviament gratuït global com a emergència: pot acceptar comandes impossibles o deficitàries.
Captura l’última adreça vàlida
Utilitza adreces controlades i anota el país, la província, el format postal, el carret i l’estat del client. Canvia un camp cada vegada.
Inspecciona update_order_review o Store API. Anota l’estat, la durada i un error segur.
No retinguis adreces reals en material compartit.
Confirma l’ordre de les zones
WooCommerce avalua des de la zona més específica fins al fallback. Comprova si correspon al codi postal, província, país o ubicacions no cobertes.
Per zona:
- països i regions
- patrons postals
- instàncies actives
- cost i condicions
- ordre davant de zones àmpliesProva espais, majúscules i zeros inicials. Comprova la normalització de l’autocompleció i l’API: abreviatures, guions o un codi estès poden ser vàlids però no coincidir amb la regla.
Inspecciona el paquet
Les tarifes es calculen per paquets. Classes, estat virtual, dimensions, pes i divisió multivendor canvien l’elegibilitat.
Compara un producte físic simple amb el carret fallit. Si falla una combinació, revisa les classes i el codi que construeix paquets.
Registra un resum segur del paquet abans i després. Si WooCommerce en construeix dos, cadascun necessita una tarifa; que un quedi sense mètode pot bloquejar tota la comanda.
Revisa les condicions del mètode
L’enviament gratuït pot dependre d’un cupó o mínim; altres instàncies poden estar desactivades o limitades.
Per a tarifes live, relaciona l’hora amb el registre. Credencials, serveis del compte, codi postal d’origen, dimensions o timeout poden retornar zero.
Verifica l’adreça d’origen, les unitats de pes i dimensió i els serveis contractats. Una migració de magatzem pot deixar l’origen antic.
Comprova que cap producte tingui pes o dimensions buits, zero o amb una unitat equivocada quan el transportista els exigeix. Un sol article mal configurat pot invalidar el paquet sencer encara que altres productes obtinguin tarifes correctament.
Rastreja el recàlcul
Els camps disparen esdeveniments JavaScript. Un tema, autocompleció o connector pot mostrar el valor sense enviar el que WooCommerce llegeix.
Inspecciona el país, la província i el codi enviats. Llegeix el primer error de Console. Si el servidor retorna tarifes però la pàgina no les mostra, l’error és de renderitzat.
No forcis update_checkout en bucle: sobrecarrega i produeix parpelleig.
Descarta caché i sessió antiga
El checkout i les tarifes no es poden compartir. Verifica les exclusions al servidor, WordPress i Cloudflare.
Si el navegador conserva un paquet antic, compara una sessió privada. Neteja només la sessió controlada.
Comprova què forma la clau de caché de tarifes. No reutilitzis una resposta d’un altre codi postal, moneda o contingut.
Repara el límit exacte
Corregeix la zona, el patró postal, el producte, la condició, les credencials o l’esdeveniment demostrat. Mostra “enviament no disponible” de manera útil quan no existeix cap mètode.
No exposis errors crus del transportista. Desa els detalls amb una referència.
Defineix una alternativa aprovada per a caigudes: recollida, tarifa manual o contacte. No inventis un preu ni acceptis una comanda impossible.
Verifica l’estabilitat
Completa comandes per a una adreça reparada i una de no suportada. Confirma tarifa, impostos, total, pagament i mètode desat.
El mètode seleccionat al navegador ha de coincidir amb l’ID i el cost guardats a la comanda. Canviar l’adreça després de seleccionar-lo ha d’obligar a recalcular; no s’ha de poder pagar amb una tarifa antiga que ja no cobreix la destinació.
Repeteix amb convidat i compte, mòbil, canvi d’adreça i diversos productes. Simula lentitud o indisponibilitat a staging i comprova que no hi ha bucles ni una tarifa antiga seleccionada.
El manteniment recurrent ha de provar destinacions representatives després de canvis de transportista, producte, checkout o WooCommerce. El recàlcul ha de ser determinista.