Crearea comenzilor WooCommerce dintr-o aplicație externă

Pașii, pe rând

1. 1Pregătește autentificareaChei cu drepturi de scriere; vezi ghidul pentru erori 401.
2. 2Mapează produseleline_items folosesc product_id (și variation_id pentru variante). Menține o mapare între SKU-ul extern și ID-ul din WooCommerce.
3. 3Construiește payload-ulbilling și shipping, payment_method și titlul lui, line_items, shipping_lines; opțional customer_id.
4. 4Decide statusul și stoculFără set_paid, comanda e pending (stocul nu se reduce la această etapă); cu set_paid: true devine processing și reduce stocul.
5. 5Validează înainte de trimitereProduse existente, cantități valide, adrese complete, prețuri corecte; evită comenzile parțiale.
6. 6Tratează erorile și dubla trimitereSalvează ID-ul comenzii create și o cheie de idempotență externă ca să nu creezi aceeași comandă de două ori la reîncercare.
7. 7TesteazăComenzi cu produse variabile, cupoane, transport; verifică stocul, emailurile și facturarea.

curl -X POST https://magazinul-tau.ro/wp-json/wc/v3/orders \
  -u ck_xxx:cs_xxx \
  -H "Content-Type: application/json" \
  -d '{
    "payment_method": "bacs",
    "payment_method_title": "Transfer bancar",
    "set_paid": false,
    "billing": {"first_name":"Ion","last_name":"Popescu","address_1":"Str. Exemplu 1","city":"București","country":"RO","email":"ion@exemplu.ro","phone":"0722123456"},
    "line_items": [{"product_id": 123, "quantity": 2}]
  }'

Cheile API și secretele webhook-urilor sunt acces la datele magazinului: nu le pune în cod public, nu le trimite pe chat și rotește-le dacă s-au expus. Documentația consultată nu marchează câmpuri obligatorii și nu detaliază emailurile sau webhook-urile declanșate de comenzile create prin API; testează.