GetDeliveryOrderInfoEx

<< 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