Ricevere merce in banchina

Risoluzione della riga d'ordine dal codice letto e registrazione dell'arrivo.

1. La merce attesa

curl -X POST https://tuaazienda.siriocloud.it/api/v1/arrivi/cerca \
  -H 'Authorization: Bearer sc_live_LATUACHIAVE' -H 'Content-Type: application/json' \
  -d '{ "fornitore": 12 }'

{
  "ordini": [ {
    "id": 4519, "data": "2026-08-10",
    "fornitore": { "id": 12, "nome": "Forniture Industriali Srl" },
    "righe": [ {
      "riga": 30112,
      "articolo": { "id": 17, "codice": "ART-001" },
      "ordinata": "50", "arrivata": "20", "residua": "30",
      "prezzo_proposto": "11.8", "chiede_lotto": false,
      "registrati": [ { "movimento": 901255, "data": "2026-08-18", "quantita": "20" } ]
    } ]
  } ],
  "totale_ordini": 1, "totale_righe": 1
}

La stessa chiamata accetta una chiave al posto dei filtri: { "barcode": "…" } con l'EAN letto dallo scanner (o l'etichetta collo stampata sull'ordine) risponde la prima riga attesa di quell'articolo. Un codice non atteso non è un errore: la risposta è vuota, con il motivo da mostrare all'operatore.

2. Registrare l'arrivo

curl -X POST https://tuaazienda.siriocloud.it/api/v1/arrivi \
  -H 'Authorization: Bearer sc_live_LATUACHIAVE' -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: bolla-7741-riga-30112' \
  -d '{
    "magazzino": 1,
    "ddt": "7741",
    "riga": 30112,
    "quantita": 30
  }'

Senza quantita si registra l'intero residuo della riga. Mai oltre l'ordinato; sugli articoli a lotti il lotto è obbligatorio ("lotto": "L-2026-09", con la scadenza se c'è). Per una consegna con più righe si passa righe: […] e la risposta contiene gli esiti per riga: una riga rifiutata non blocca le altre.

3. Annullare un arrivo

Ogni arrivo registrato risponde con l'id del movimento, presente anche nei registrati del punto 1:

curl -X POST https://tuaazienda.siriocloud.it/api/v1/arrivi/901260/annulla -H 'Authorization: Bearer sc_live_LATUACHIAVE'

L'annullo riapre il residuo, ricalcola lo stato dell'ordine e riallinea le giacenze.