|
<< Click pentru afișare cuprins >> Navigare: SmartCash Everywhere REST Server > Metode de citire SmartCash Everywhere REST Server > Metode de citire pentru documente si informatii operationale > GetModifiedDeliveryOrderEx |
Metoda GetModifiedDeliveryOrderEx este utilizata pentru regasirea comenzilor modificate sau nou adaugate in dispeceratul de comenzi din sistemul SmartCash RMS de la ultima apelare a aceleiasi metode si trebuie urmata de confirmare prin metoda ConfirmReceivingDataByTypeOf (aTypeOf=2). Metoda intoarce o lista de comenzi, avand aceeasi structura de campuri ca si metoda GetDeliveryOrderInfoEx.
Pentru fiecare comanda pe langa informatiile principale sunt returnate de asemenea, 4 noduri JSON: ORDER_ITEMS, PICKING_ORDER_ITEMS, INVOICE_ITEMS si STATUS_CHANGE. Acestea contin liste de articole existente in toate cele 3 faze de procesare ale unei comenzi, precum si lista tuturor statusurilor prin care a trecut comanda. Daca unul dintre nodurile ORDER_ITEMS, PICKING_ORDER_ITEMS, INVOICE_ITEMS este gol, atunci inseamna ca respectiva comanda nu a ajuns inca in stadiul respectiv.
Ordinea de operare a unei comenzi si deci de populare ale primelor 3 noduri la apeluri succesive ale metodei, este totdeauna: ORDER_ITEMS > PICKING_ORDER_ITEMS > INVOICE_ITEMS.
Cele 3 noduri reprezinta pe rand:
ORDER_ITEMS = Lista de articole primite prin interfata de la aplicatia terta in dispeceratul de comenzi,
PICKING_ORDER_ITEMS = Lista de articole pentru care se efectueaza picking-ul pentru documentul de picking (comanda de livrare/aviz) PICKING_ORDER_NUMBER,
INVOICE_ITEMS = Lista de articole facturate efectiv catre clientul final pe factura INVOICE_NUMBER.
STATUS_CHANGE = Lista cronologica a tuturor evenimentelor de schimbare de stare pentru comanda respectiva.
Parametri Apel
Parametru |
Descriere |
Tip Date |
aIDAPP |
ID unic alocat aplicatiei care se conecteaza la serverul REST SmartCash |
Integer |
Campuri JSON returnate
Camp |
Descriere |
Tip Date |
IDDELIVERY |
ID-ul unic al comenzii in dispeceratul de comenzi SmartCash (cheia primara) |
Integer |
IDSMARTCASH_CUSTOMER |
ID-ul unic al clientului in programul SmartCash |
Integer |
SMARTCASH_CUSTOMER |
Numele clientului in programul SmartCash |
String |
IDEXTAPP_CUSTOMER |
Codul clientului in sistemul extern |
String |
ORDER_NUMBER |
Numarul comenzii din sistemul extern |
String |
ORDER_DATE |
Data comenzii |
String |
STATUS |
Starea comenzii. Valorile posibile sunt: STATUS=1 – Deschis STATUS=2 – In Asteptare STATUS=3 – In Lucru STATUS=4 – Facturat STATUS=5 – Returnat STATUS=6 – Anulat La deschiderea unei comenzi noi ea trebuie sa fie deschisa cu STATUS=1. |
Integer |
STATUS_SUBTYPE |
Subtipul starii comenzii. Valorile posibile sunt:
Pentru STATUS=1 STATUS_SUBTYPE=0 – Nimic
Pentru STATUS=2 STATUS_SUBTYPE=21 - In Asteptarea Platii STATUS_SUBTYPE=22 - Procesabil
Pentru STATUS=3 STATUS_SUBTYPE=31 – Picking Neinceput STATUS_SUBTYPE=32 – Picking Finalizat
Pentru STATUS=4 STATUS_SUBTYPE=41 – Neambalat STATUS_SUBTYPE=42 – Ambalat STATUS_SUBTYPE=43 – Expediat STATUS_SUBTYPE=44 – Retur Postal STATUS_SUBTYPE=45 – Confirmat Primirea
Pentru STATUS=5 STATUS_SUBTYPE=51 – Returnat Partial STATUS_SUBTYPE=52 – Returnat Integral
Pentru STATUS=6 STATUS_SUBTYPE=61 – Razgandire STATUS_SUBTYPE=62 – Modificare STATUS_SUBTYPE=63 – Lipsa Stoc STATUS_SUBTYPE=64 – Alte Motive |
Integer |
TYPEOF_PAYMENT |
Tipul de plata selectata de catre client pentru comanda. Valori posibile: TYPEOF_PAYMENT=1 – Numerar Ramburs TYPEOF_PAYMENT=2 – CARD TYPEOF_PAYMENT=3 – Ordin de Plata TYPEOF_PAYMENT=4 – Altele |
Integer |
TYPEOF_PAYMENT_GATEWAY |
Procesatorul de plati folosit la plata online. Valori posibile: TYPEOF_PAYMENT_GATEWAY =1 – PayPal TYPEOF_PAYMENT_GATEWAY =2 – MobilPay TYPEOF_PAYMENT_GATEWAY =3 – LibraPay TYPEOF_PAYMENT_GATEWAY =4 – iPay Transilvania |
Integer |
CARD_TRANSACTION_ID |
ID-ul tranzactiei platii. (daca exista) |
String |
TYPEOF_DELIVERY |
Modul de livrare pentru comanda respectiva. Valori posibile: TYPEOF_DELIVERY=1 – Posta TYPEOF_DELIVERY=2 – Curier Rapid TYPEOF_DELIVERY=3 – Altele |
Integer |
LAST_USER_MODIFY |
Numele ultimului Operator SmartCash care a modificat comanda in dispeceratul de comenzi SmartCash. |
String |
IDSMARTCASH_LAST_USER_MODIFY |
ID-ul unic de operator SmartCash corespunzator operatorului care a facut ultima modificare a comenzii. |
Integer |
LAST_MODIFIY_TIME |
Data si ora ultimei modificari a comenzii |
String |
COUNTRY |
Tara |
String |
STATE |
Judetul |
String |
TOWN |
Localitatea |
String |
ADDRESS |
Adresa |
String |
POSTALCODE |
Codul postal |
String |
ORDER_OBS |
Observatii referitoare la comanda. Acest camp este imprimat automat si pe factura comenzii. |
String |
ORDER_OPERATOR_OBS |
Observatii pentru operator. Acest camp NU este imprimat pe factura comenzii. |
String |
ORDER_ITEMS |
Nod de tip JSON Array care contine articolele comenzii, asa cum a fost ea primita de la aplicatia terta prin metoda AddNewDeliveryOrder. |
Array |
START_USER_NAME |
Numele operatorului care a lansat comanda in lucru si a deschis efectiv o noua comanda de livrare. Marcheaza inceputul operatiei de picking, respectiv autorizarea livrarii. |
String |
START_USER_IDSMARTCASH |
ID-ul unic de operator SmartCash corespunzator operatorului care a lansat comanda in lucru. |
Integer |
START_TIME |
Data si ora exacta a lansarii in lucru si a inceputului operatiei de picking. |
String |
PICKING_ORDER_NUMBER |
Numarul comenzii de livrare din sistemul SmartCash pe baza careia s-a efectuat colectarea produselor in magazinul care livreaza comanda. |
Integer |
PICKING_TIME |
Data si ora exacta a finalizarii pickingului si a emiterii comenzii de livrare. Acest camp este egal cu data comenzii de livrare. |
String |
PICKING_USER_NAME |
Numele operatorului care a finalizat pickingul si a emis comanda de livrare corespunzatoare in vederea facturarii. Marcheaza sfarsitul operatiei de picking. |
String |
PICKING_USER_IDSMARTCASH |
ID-ul unic de operator SmartCash corespunzator operatorului care a finalizat pickingul si a emis comanda de livrare corespunzatoare in vederea facturarii. |
Integer |
PICKING_NRSHOP |
Codul magazinului care a efectuat livrarea comenzii asa cum este el stabilit de catre utilizatori in sistemul SmartCash. El este si codul magazinului in care se emite factura de livrare. |
Integer |
PICKING_ORDER_ITEMS |
Nod de tip JSON Array care contine articolele colectate efectiv din comanda primita, care sunt inregistrate pe o comanda de livrare interna avand numarul PICKING_ORDER_NUMBER. |
Array |
INVOICE_NUMBER |
Numarul facturii emise pentru comanda de livrare. |
String |
INVOICE_TIME |
Data si ora exacta a emiterii facturii. |
String |
INVOICE_USER_NAME |
Numele operatorului care a emis factura corespunzatoare comenzii curente de livrare. |
String |
INVOICE_USER_IDSMARTCASH |
ID-ul unic de operator SmartCash corespunzator operatorului care a emis factura. |
Integer |
INVOICE_ITEMS |
Nod de tip JSON Array care contine articolele facturate in magazin. |
Array |
SHIPPING_DATE |
Data culeasa de operator care corespunde predarii produselor din comanda catre transportator (curier). |
String |
SHIPPING_DOC |
Documentul de predare (AWB) a produselor din comanda catre transportator (curier). |
String |
SHIPPING_OBS |
Observatii legate de predarea produselor din comanda catre transportator (curier). |
String |
SHIPPING_USER_NAME |
Numele operatorului care a predat produsele catre transportator. |
String |
SHIPPING_USER_IDSMARTCASH |
ID-ul unic de operator SmartCash corespunzator operatorului care a predat produsele catre transportator. |
Integer |
SHIPPING_TIME |
Data si ora exacta a consemnarii predarii produselor in sistemul SmartCash. |
String |
SHIPPING_NRSHOP |
Codul magazinului din care trebuie efectuata livrarea comenzii asa cum este el transmis de catre aplicatia terta prin metoda AddNewDeliveryOrder in campul NRSHOP. |
Integer |
DELIVERY_DATE |
Data culeasa de operator care corespunde livrarii produselor din comanda catre clientul final de catre transportator (curier). |
String |
DELIVERY_CONF_DOC |
Documentul de confirmare a livrarii catre clientul final. |
String |
DELIVERY_CONF_USER_NAME |
Numele operatorului care a consemnat confirmarea livrarii catre clientul final in sistemul SmartCash. |
String |
DELIVERY_CONF_USER_IDSMARTCASH |
ID-ul unic de operator SmartCash corespunzator operatorului care a consemnat confirmarea livrarii catre clientul final in sistemul SmartCash. |
Integer |
DELIVERY_CONF_TIME |
Data si ora exacta a consemnarii livrarii produselor in sistemul SmartCash. |
String |
RETURN_DATE |
Data culeasa de operator care corespunde returului produselor din comanda in cazul in care s-a intamplat acest lucru. |
String |
RETURN_DOC |
Numarul documentului de retur. |
String |
RETURN_PAYMENT_DOC |
Numarul documentului de rambursare a sumei catre client. |
String |
RETURN_USER_NAME |
Numele operatorului care a consemnat returul in sistemul SmartCash. |
String |
RETURN_USER_IDSMARTCASH |
ID-ul unic de operator SmartCash corespunzator operatorului care a consemnat returul in sistemul SmartCash. |
Integer |
RETURN_TIME |
Data si ora exacta a consemnarii returului in sistemul SmartCash. |
String |
CANCEL_USER_NAME |
Numele operatorului care a consemnat anularea comenzii in sistemul SmartCash. |
String |
CANCEL_USER_IDSMARTCASH |
ID-ul unic de operator SmartCash corespunzator operatorului care a consemnat anularea comenzii in sistemul SmartCash. |
Integer |
CANCEL_OBS |
Observatiile legate de anularea comenzii. |
String |
CANCEL_TIME |
Data si ora exacta a consemnarii anularii comenzii in sistemul SmartCash. |
String |
ORDER_OBS |
Observatii referitoare la comanda. Acest camp este imprimat automat si pe factura comenzii. |
String |
ORDER_OPERATOR_OBS |
Observatii pentru operator. Acest camp NU este imprimat pe factura comenzii. |
String |
ORDER_ITEMS |
Nod de tip JSON Array care contine articolele comenzii, asa cum a fost ea primita de la aplicatia terta prin metoda AddNewDeliveryOrder. |
Array |
Campuri JSON returnate in nodul ORDER_ITEMS
Camp |
Descriere |
Tip Date |
IDSMARTCASH_ARTICLE |
Codul unic al articolului in sistemul SmartCash. ID-ul are valori intregi, pozitive si crescatoare pentru orice articol (marfa sau servicii) adaugat de catre utilizatori in SmartCash. Pe comenzi, ID-ul poate avea si urmatoarele valori negative, predefinite intern si rezervate pentru o serie de operatii comerciale: -8 = DISCOUNT VALORIC COTA TVA A -9 = DISCOUNT VALORIC COTA TVA B -10 = DISCOUNT VALORIC COTA TVA C -11 = DISCOUNT VALORIC COTA TVA D -12 = DISCOUNT VALORIC COTA TVA E |
Integer |
IDEXTAPP_ARTICLE |
Codul articolului in sistemul extern |
|
NAME |
Denumirea articolului asa cum a fost inregistrata ea pe comanda |
String |
QTY |
Cantitatea |
Float |
PRICE |
Pretul de vanzare inclusiv TVA-ul |
Float |
Campuri JSON returnate in nodul PICKING_ORDER_ITEMS
Camp |
Descriere |
Tip Date |
IDSMARTCASH_ARTICLE |
Codul unic al articolului in sistemul SmartCash. ID-ul are valori intregi, pozitive si crescatoare pentru orice articol (marfa sau servicii) adaugat de catre utilizatori in SmartCash. Pe comenzi, ID-ul poate avea si urmatoarele valori negative, predefinite intern si rezervate pentru o serie de operatii comerciale: -8 = DISCOUNT VALORIC COTA TVA A -9 = DISCOUNT VALORIC COTA TVA B -10 = DISCOUNT VALORIC COTA TVA C -11 = DISCOUNT VALORIC COTA TVA D -12 = DISCOUNT VALORIC COTA TVA E |
Integer |
IDDELIVERY |
ID-ul unic al comenzii in dispeceratul de comenzi SmartCash (cheia primara) |
Integer |
NAME |
Denumirea articolului asa cum a fost inregistrata ea pe comanda de livrare interna folosita la operatia de picking. Implicit este egala cu denumirea primita de la aplicatia terta dar poate suferi modificari. |
String |
QTY |
Cantitatea |
Float |
PRICE |
Pretul de vanzare inclusiv TVA-ul |
Float |
Campuri JSON returnate in nodul INVOICE_ITEMS
Camp |
Descriere |
Tip Date |
IDSMARTCASH_ARTICLE |
Codul unic al articolului in sistemul SmartCash. ID-ul are valori intregi, pozitive si crescatoare pentru orice articol (marfa sau servicii) adaugat de catre utilizatori in SmartCash. Pe comenzi, ID-ul poate avea si urmatoarele valori negative, predefinite intern si rezervate pentru o serie de operatii comerciale: -8 = DISCOUNT VALORIC COTA TVA A -9 = DISCOUNT VALORIC COTA TVA B -10 = DISCOUNT VALORIC COTA TVA C -11 = DISCOUNT VALORIC COTA TVA D -12 = DISCOUNT VALORIC COTA TVA E |
Integer |
IDEXTAPP_ARTICLE |
Codul articolului in sistemul extern |
|
NAME |
Denumirea articolului asa cum a fost inregistrata ea pe factura. Implicit este egala cu denumirea primita de la aplicatia terta dar poate suferi modificari. |
String |
SALE_UM |
UM Vanzare |
Float |
UNIT_PRICE |
Pretul de vanzare unitar inclusiv TVA |
Float |
SALE_VALUE_VAT_INCLUDED |
Valoarea de vanzare la pret intreg intreaga inclusiv TVA |
Float |
DISCOUNT_VALUE_VAT_INCLUDED |
Valoarea discount-ului la pret de vanzare inclusiv TVA |
Float |
DISCOUNTED_SALE_VALUE_VAT_INCLUDED |
Valoarea incasata efectiv pentru articolul respectiv, inclusiv TVA dupa aplicarea discount-ului. |
Float |
DISCOUNTED_SALE_VALUE |
Valoarea incasata efectiv pentru articolul respectiv, exclusiv TVA dupa aplicarea discount-ului. |
Float |
VAT_PERCENT |
Procentul de TVA |
Float |
VAT_SALE_VALUE |
Valoarea TVA-ului calculat din valoarea intreaga de vanzare (la pret de raft) |
Float |
VAT_DISCOUNTED_SALE_VALUE |
Valoarea TVA-ului calculat din valoarea redusa de vanzare (valoarea incasata rezultata dupa aplicarea discount-ului) |
Float |
BATCH |
Lotul de fabricatie |
String |
BATCH_DATE |
Data lotului de fabricatie |
String |
BATCH_DESCRIPTION |
Descrierea lotului de fabricatie |
String |
Campuri JSON returnate in nodul STATUS_CHANGE
Camp |
Descriere |
Tip Date |
IDSMARTCASH |
Codul unic al fiecarei inregistrari de schimbare de status in sistemul SmartCash. ID-ul are valori intregi, pozitive si crescatoare. |
Integer |
IDEXTAPP_ARTICLE |
Codul articolului in sistemul extern |
|
OLD_STATUS |
Starea comenzii inaintea efectuarii schimbarii de status. Valorile posibile sunt: STATUS=1 – Deschis STATUS=2 – In Asteptare STATUS=3 – In Lucru STATUS=4 – Facturat STATUS=5 – Returnat STATUS=6 – Anulat |
Integer |
OLD_STATUS_SUBTYPE |
Subtipul starii comenzii inaintea efectuarii schimbarii de status. Valorile posibile sunt:
Pentru STATUS=1 STATUS_SUBTYPE=0 – Nimic
Pentru STATUS=2 STATUS_SUBTYPE=21 - In Asteptarea Platii STATUS_SUBTYPE=22 - Procesabil
Pentru STATUS=3 STATUS_SUBTYPE=31 – Picking Neinceput STATUS_SUBTYPE=32 – Picking Finalizat
Pentru STATUS=4 STATUS_SUBTYPE=41 – Neambalat STATUS_SUBTYPE=42 – Ambalat STATUS_SUBTYPE=43 – Expediat STATUS_SUBTYPE=44 – Retur Postal STATUS_SUBTYPE=45 – Confirmat Primirea
Pentru STATUS=5 STATUS_SUBTYPE=51 – Returnat Partial STATUS_SUBTYPE=52 – Returnat Integral
Pentru STATUS=6 STATUS_SUBTYPE=61 – Razgandire STATUS_SUBTYPE=62 – Modificare STATUS_SUBTYPE=63 – Lipsa Stoc STATUS_SUBTYPE=64 – Alte Motive |
Integer |
STATUS |
Starea comenzii dupa efectuarea schimbarii de status. Valorile posibile sunt: STATUS=1 – Deschis STATUS=2 – In Asteptare STATUS=3 – In Lucru STATUS=4 – Facturat STATUS=5 – Returnat STATUS=6 – Anulat |
Integer |
STATUS_SUBTYPE |
Subtipul starii comenzii dupa efectuarea schimbarii de status. Valorile posibile sunt: Pentru STATUS=1 STATUS_SUBTYPE=0 – Nimic
Pentru STATUS=2 STATUS_SUBTYPE=21 - In Asteptarea Platii STATUS_SUBTYPE=22 - Procesabil
Pentru STATUS=3 STATUS_SUBTYPE=31 – Picking Neinceput STATUS_SUBTYPE=32 – Picking Finalizat
Pentru STATUS=4 STATUS_SUBTYPE=41 – Neambalat STATUS_SUBTYPE=42 – Ambalat STATUS_SUBTYPE=43 – Expediat STATUS_SUBTYPE=44 – Retur Postal STATUS_SUBTYPE=45 – Confirmat Primirea
Pentru STATUS=5 STATUS_SUBTYPE=51 – Returnat Partial STATUS_SUBTYPE=52 – Returnat Integral
Pentru STATUS=6 STATUS_SUBTYPE=61 – Razgandire STATUS_SUBTYPE=62 – Modificare STATUS_SUBTYPE=63 – Lipsa Stoc STATUS_SUBTYPE=64 – Alte Motive |
Integer |
IDSMARTCASH_USER |
ID-ul unic de operator SmartCash corespunzator operatorului care a efectuat operatia care a dus la modificarea de stare. (Responsabil de STATUS). |
Integer |
SMARTCASH_USER |
Numele operatorului care a efectuat operatia care a dus la modificarea de stare. (Responsabil de STATUS). |
String |
EVENT_TIME |
Data si ora schimbarii de stare. |
String |
OTHER_INFO |
Sir de caractere formatat JSON care defineste detalii despre schimbarea respectiva de stare. Este completat la una din operatiile: STATUS=3, STATUS_SUBTYPE=31 PICKING_ORDER_NUMBER – Numarul comenzii de livrare in sistemul SmartCash RMS. PICKING_NRSHOP – Numarul magazinului care a preluat comanda de livrare pentru picking. PICKING_TIME – Data si ora inceperii operatiei de picking.
STATUS=4, STATUS_SUBTYPE=41 INVOICE_NUMBER – Numarul facturii INVOICE_NRSHOP – Numarul magazinului care a emis factura. INVOICE_TIME – Data emiterii facturii. INVOICE_USER_NAME – Numele si prenumele operatorului care a emis factura.
STATUS=4, STATUS_SUBTYPE=42 INVOICE_NUMBER – Numarul facturii INVOICE_NRSHOP – Numarul magazinului care a emis factura. INVOICE_TIME – Data emiterii facturii. INVOICE_USER_NAME – Numele si prenumele operatorului care a emis factura. SHIPPING_DOC - AWB SHIPPING_NRSHOP – Numarul magazinului de unde a fost expediat. SHIPPING_COMPANY – Numele firmei de curierat. SHIPPING_USER_NAME – Nume si prenume operator expediere.
STATUS=7, STATUS_SUBTYPE=71 INTERNAL_TRANSFER_NRSHOP – Numar Magazin destinatie pentru transferul de marfa. INTERNAL_TRANSFER_NUMBER – Numarul avizului de insotire corespunzator transferului de marfa.
STATUS=7, STATUS_SUBTYPE=72 SHIPPING_DOC - AWB SHIPPING_NRSHOP – Numarul magazinului de unde a fost expediat. SHIPPING_COMPANY – Numele firmei de curierat. SHIPPING_USER_NAME – Nume si prenume operator expediere. SHIPPING_DATE – Data expedierii. |
String |