|
<< 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 > GetDeliveryOrderInfoEx |
Metoda GetDeliveryOrderInfoEx este utilizata pentru intoarcerea tuturor informatiilor disponibile despre o comanda de livrare deschisa in cadrul dispeceratului de comenzi SmartCash RMS. Rezultatul este un JSON in care este returnata comanda, articolele cuprinse pe aceasta, si articolele facturate asociate acestei comenzi.
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 |
aTypeOf |
Flag care specifica tipul de cod dupa care se face cautarea comenzii in baza de date Smartcash RMS. Daca aTypeOf=1 cautarea se face dupa IDDELIVERY, codul intern unic SmartCash pentru orice comanda. Daca aTypeOf=2 cautarea se face dupa ORDER_NUMBER, codul de comanda atribuit de aplicatia externa la deschiderea comenzii. Daca aTypeOf=3 cautarea se face dupa SHIPPING_DOC. |
Integer |
aValueSearch |
Valoarea codului IDDELIVERY, ORDER_NUMBER sau SHIPPING_DOC dupa care se face cautarea corespunzator flag-ului aTypeOf. |
String |
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 |