Nexus ERP

1.4.12. Importul comenzilor de la clienti

Parametri

Câmp

Tip

Descriere

 id_importex  

 varchar(50) 

 ID pentru identificarea unui lot de documente importate (util, de ex., pentru ștergerea în bloc a unui lot de documente importate).

 single_tran 

 bit

 Se specifica daca se va deschide o singura tranzactie pentru intregul import sau se va utiliza o tranzactie per document.

 1 - in cazul aparitiei unei erori la importul unui document, sistemul va reveni complet la starea dinaintea importului.

 - documentele importate pana la aparitia erorii raman in baza de date.


http://{ip}:{port}/api/v1/import/comenzi_clienti

Câmp

Tip

Descriere

id_document

varchar(25)

ID unic pentru identificarea documentului 

tip_document

varchar(15)

Tipul documentului (Comanda client, Comanda interna, Deviz lucrări) (opțional, implicit Comanda client)

id_carnet

bigint

Codul intern al carnetului din care este emis documentul (opțional)

serie_document

varchar(10)

Seria documentului (opțional)

numar_document

varchar(20)

Numărul documentului

data_document

date

Data documentului

data_valabil

date

Data de valabilitate a comenzii    

data_livrare

date

Data livrării    

scadenta

smallint

Număr de zile scadente de la data documentului    

moneda

char(3)

Moneda (RON, EUR) (opțional, implicit RON)

id_gestiune

varchar(25)

Codul intern al gestiunii în formatul ID(PCT_LCR). Dacă se specifică doar ID-ul, atunci punctul de lucru este considerat implicit 1 (opțional dacă se specifică den_gestiune)    

den_gestiune

varchar(30)

Denumirea gestiunii (opțional dacă se specifică id_gestiune)    

id_client

varchar(25)

Codul intern al clientului în formatul ID(PCT_LCR). Dacă se specifică doar ID-ul, atunci punctul de lucru este considerat implicit 1 (opțional dacă se specifică cif_client sau  den_client)

cif_client

varchar(20)

Codul fiscal / CNP al clientului (opțional dacă se specifică id_client sau  den_client)

den_client

varchar(100)

Denumirea clientului (opțional dacă se specifică id_client sau  cif_client)    

id_agent

varchar(25)

Codul intern al agentului în formatul ID(PCT_LCR). Dacă se specifică doar ID-ul, atunci punctul de lucru este considerat implicit 1 (opțional dacă se specifică den_agent)    

den_agent

varchar(30)

Denumirea agentului (opțional dacă se specifică id_agent)    

id_delegat

varchar(25)

Codul intern al delegatului în formatul ID(PCT_LCR). Dacă se specifică doar ID-ul, atunci punctul de lucru este considerat implicit 1 (opțional dacă se specifică den_delegat)    

den_delegat

varchar(100)

Denumirea delegatuluio (opțional dacă se specifică id_delegat)    

id_pregatire

varchar(25)

Codul intern al salariatului însărcinat cu pregătirea comenzii în formatul ID(PCT_LCR). Dacă se specifică doar ID-ul, atunci punctul de lucru este considerat implicit 1 (opțional dacă se specifică den_pregatire)

den_pregatire

varchar(30)

Denumirea salariatului însărcinat cu pregătirea comenzii  (opțional dacă se specifică id_pregatire)

id_adresa

varchar(25)

Codul intern al adresei în formatul ID(PCT_LCR). Dacă se specifică doar ID-ul, atunci adresa este considerat implicit 1 (opțional dacă se specifică den_adresa)

den_adresa

varchar(200)

Denumirea adresei (opțional dacă se specifică id_adresa)

observatii

varchar(250)

Observații document

rezervare

bit

Cu rezervare marfă pe stoc

aprobare

bit

Comanda  aprobata

validare

bit

Se va valida sau nu documentul după salvare

valoare

money

Valoarea inclusiv TVA pentru control final

id_ruta

varchar(25)

Codul intern al rutei în formatul ID(PCT_LCR). Dacă se specifică doar ID-ul, atunci ruta este considerat implicit 1 (opțional dacă se specifică den_ruta)

den_ruta

varchar(100)

Denumirea rutei (opțional dacă se specifică id_ruta)

id_gestiune_in

varchar(25)

Codul intern al gestiunii de intrare în formatul ID(PCT_LCR). Dacă se specifică doar ID-ul, atunci punctul de lucru este considerat implicit 1 (opțional dacă se specifică den_gestiune_int)

den_gestiune_in

varchar(30)

Denumirea gestiunii de intrare(opțional dacă se specifică id_gestiune_int)

id_program

varchar(25)

Codul intern al programului în formatul ID(PCT_LCR). Dacă se specifică doar ID-ul, atunci programul este considerat implicit 1 (opțional dacă se specifică den_program)

den_program

varchar(250)

Denumirea programului (opțional dacă se specifică id_program)

discount

money

Discount

discount_proc

decimal(5,2)

Discount procentual

id_cursa

varchar(25)

Codul intern al comenzii în formatul ID(PCT_LCR). Dacă se specifică doar ID-ul, atunci punctul de lucru este considerat implicit 1 (opțional, dacă se specifică den_cursa)

den_cursa

varchar(100)

Denumirea cursei (opțional, dacă se specifică id_cursa)

taxare_inversa

bit

Comanda cu taxare inversa (opțional, implicit 0) 

blocare_aplicare_promo

bit

Blocare aplicare promotii. In cazul in care se completeaza cu valoarea 1, promotiile nu se vor mai aplica la adaugarea comenzii.

id_curier

numeric(18,0)

Id-ul curierului (Optional daca se specifica nume_curier) 

nume_curier

varchar(100)

Nume curier. Optional daca se specifica id_curier.

id_extern_client

varchar(50)

Id-ul extern al clientului 

id_extern_adresa

varchar(50)

Id extern adresa

id_mod_livrare

numeric(18,0)

Id mod livrare (Optional daca se specifica den_mod_livrare).Sunt modurile de livrare din pagina "Modalitati livrare" din Magazine Online. 

den_mod_livrare

nvarchar(200)

Denumire mod livrare (Optional daca se specifica id_mod_livrare). Sunt modurile de livrare din pagina "Modalitati livrare" din Magazine Online.

mod_plt

varchar(25)

Reprezinta modul prin care este efectuata plata comenzii

obs_tip_fctnvarchar(500) Se completeaza cu observatii de tiparit pe formularul facturii fiscale.
identifvarchar(50) Se completeaza identificatorul comenzii.
val_rambursnumeric(15,2) Se completeaza valoarea ramburs.
id_emagnumeric(18,0)  Id-ul magazinului online

Tabel 18. Date import antet comenzi clienți

http://{ip}:{port}/api/v1/import/comenzi_clienti

Câmp

Tip

Descriere

id_produs

varchar(25)

Codul intern al produsului în formatul ID(PCT_LCR). Dacă se specifică doar ID-ul, atunci punctul de lucru este considerat implicit 1 (opțional dacă se specifică cod_produs sau  den_produs)    

cod_produs

varchar(20)

Codul de bare al produsului (opțional dacă se specifică id_produs sau  den_produs)    

den_produs

varchar(173)

Denumirea produsului (opțional dacă se specifică id_produs sau  cod_produs)    

tip_produs

varchar(3)

Codul din 3 caractere corespunzător tipului de produs definit in nomenclatorul de bunuri si servicii (opțional dacă se specifică cont_produs)    

cont_produs

varchar(17)

Contul produsului (opțional dacă se specifică tip_produs)    

serie_produs

varchar(50)

Seria/numărul de lot al produsului (opțional)    

cantitate

numeric(13,3)

Cantitatea    

pret_vanzare

money

Prețul de vânzare fără TVA in moneda facturii (dacă se omite, se calculează automat din prețul de vânzare cu TVA)    

pret_vanzare_tva

money

Prețul de vânzare cu TVA in moneda facturii (dacă se omite, se calculează automat din prețul de vânzare fără TVA)    

cota_tva_ies

numeric(2,0)

Cota TVA ieșire (opțional, implicit e preluata din nomenclator)    

data_expirare

date

Data expirării (opțional)    

denumire_sup

varchar(250)

Denumire suplimentara (opțional)    

discount

money

Discount

discount_proc

decimal(5,2)

Discount procentual

pret_furnizor

money

Prețul de achiziție al produsului de la furnizor

id_linie_document

varchar(25)

Id linie document utilizat pentru relația cu tabela importex_comenzi_clienti_antecalcul 

cantitate2

numeric(13,3)

Cantitate 2    

id_extern_produs

varchar(25)

Id-ul extern al produsului(optional daca se specifica cod_produs, id_produs sau den_produs)

Tabel 19. Date import linii comenzi clienți


Exemplu de import in format Json
{ 

       "parametri" :

                         {

                            "single_tran" : 1,

                            "id_importex": "WEB20210401"

                        },

"antete": [
{
"id_document": "11199",
"tip_document": "Comanda client",
"id_carnet": "91",
"serie_document": "SITE",
"numar_document": "",
"data_document": "2018-02-07",
"data_valabil": "2018-02-07",
"data_livrare": "2018-02-08T00:00:00",
"scadenta": "20",
"moneda": "RON",
"id_gestiune": "29(1)",
"den_gestiune": "",
"id_client": "190464(1)",
"cif_client": "",
"den_client": "NEXUS MEDIA SRL",
"id_gestiune_in": "",
"den_gestiune_in": "",
"id_agent": "1(1)",
"den_agent": "",
"id_pregatire": "",
"den_pregatire": "",
"id_adresa": "",
"den_adresa": "",
"id_ruta": "",
"den_ruta": "",
"id_program": "",
"den_program": "",
"id_cursa": "",
"den_cursa": "",
"rezervare": "0",
"aprobare": "1",
"taxare_inversa": "0",
"validare": "1",
"observatii": "Modalitate de plata+ Avans,",
"discount": "0.0000",
"discount_proc": "0.00",
"valoare": "0.0000",
"linii": [
{
"id_linie_document": "38434",
"id_produs": "",
"cod_produs": "6565656",
"den_produs": "caiet",
"tip_produs": "FAA",
"cont_produs": "",
"serie_produs": "",
"cantitate": "2000.000",
"cantitate2": "400.000",
"pret_furnizor": "4500.0000",
"pret_vanzare": "5000.0000",
"discount": "0.0000",
"discount_proc": "0.00",
"denumire_sup": ""
}]
}]
}


Pentru anularea importului se utilizeaza: http://{ip}:{port}/api/v1/import/comenzi_clienti_anulare

Exemplu de obiect Json folosit pentru apel:

{

"id_importex" : "NX20180911150146"

}