Nexus ERP

1.4.29. Importul produselor

Parametri

Câmp

Tip

Descriere

 id_importex  

 varchar(25) 

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

 manage_existing 

 tinyint

 0 - Blocheaza

 1 - Suprascrie

 2 - Ignora

 updated_columns 

 varchar(max) 

 Se va trimite lista de campuri ce se doresc a fi suprascrise, separate prin virgula (fara spatiu intre campuri si virgula).

 single_tran 

 bit

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

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

Câmp

Tip

Descriere

id_produs

varchar (25)

ID-ul extern al produsului (din aplicatia terța, opțional dacă se specifică cod_ext sau denumire)

tip

char(1)

 Pentru tip produs utilizați una din variantele:
 N  = Produs obișnuit (marfa cu amănuntul, marfa cu ridicata ... etc)
 P  = Cheltuieli (achiziții de servicii, produse înregistrate direct pe cheltuieli ... etc)
 S  = Servicii oferite (servicii proprii vândute catre clienți)
 W = Discounturi oferite
 X  = Discounturi primite
 M = Imobilizări 

cod_extern

varchar (20)

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

denumire

nvarchar(110)

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

descriere

varchar (120)

Descriere produs sau o continuare a denumirii (opțional)

um

varchar (8)

Unitatea de măsura a produsului. Trebuie sa existe unitatea de măsura in tabelul um.

um2

varchar (8)

Unitatea de măsura 2 a produsului.

conv_um2

numeric(18,8)

Conversie UM2

cota_tva_int

numeric(2)

Cota de TVA utilizata la recepția produsului. Trebuie sa existe cota de TVA in tabelul cote_tva.

cota_tva_ies

numeric(2)

Cota de TVA utilizata la vânzarea produsului. Trebuie sa existe cota de TVA in tabelul cote_tva.

id_clasa

varchar (25)

Id-ul clasei de produse, din tabelul nomen1 în formatul ID(PCT_LCR) sau doar ID. Dacă se specifică doar ID-ul, atunci punctul de lucru este considerat implicit 1. (opțional dacă se specifică den_clasa)

den_clasa

varchar (30)

Denumirea clasei de produse (opțional dacă se specifică id_clasa).

id_subclasa

varchar (25)

Id-ul sub-clasei de produse, din tabelul nomen2 în formatul ID(PCT_LCR) sau doar ID. Dacă se specifică doar ID-ul, atunci punctul de lucru este considerat implicit 1. (opțional)

den_subclasa

varchar (30)

Denumirea sub-clasei de produse (opțional dacă se specifică id_subclasa).

id_brand

varchar (25)

Id-ul brandu-lui de produse, din tabelul brand în formatul ID(PCT_LCR) sau doar ID. Dacă se specifică doar ID-ul, atunci punctul de lucru este considerat implicit 1. (opțional)

den_ brand

varchar (30)

Denumirea brandu-lui de produse (opțional dacă se specifică id_brand).

volum

numeric (7,3)

Volumul per unitatea de măsura exprimat in metri cubi (opțional). Informație utila, de ex., pentru modulul de logistica livrări.

ambalare

numeric(10,2)

Cantitatea de produs per unitate de ambalare (opțional). Informație utila, de ex., pentru modulul de comenzi la furnizori.

garantie

smallint

Numărul de luni de garantie (opțional).

densitate

numeric (7,4)

Densitatea specifica (opțional).

latime

numeric(15,3)

Lățimea produsului in mm (opțional).

valoric

bit

Dacă se dorește doar evidenta valorica (nu si cantitativa) a unui produs = 1, iar in mod normal = 0.

cod_echiv_furnizor

varchar(max)

Coduri echivalente separate prin spațiu.

observatii

varchar(1000)

Observații diverse atașate produsului (opțional). Informație utila, de ex., pentru afișarea unei descrieri mai ample pe un site de vânzări.

id_intern

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_ext sau denumire)

status

varchar (50)

Statusul produsului

greutate

decimal(7,3)

Masa produsului

spec_tip

char(3)

Specificații - Tip

spec_descriere

nvarchar(max)

Specificații - Descriere

spec_instalare

nvarchar(max)

Specificații - Instalare

spec_utilizare

nvarchar(max)

Specificații - Utilizare

locație

nvarchar(max)

Locație

cod_tara_origine

varchar(max)

Cod tara origine produs.

cod_nc8

int

Cod NC8 din nomenclatorul de produse.

id_furn

varchar (25)

Id-ul furnizorului de produse, din tabelul nomen3 în formatul ID(PCT_LCR) sau doar ID. Dacă se specifică doar ID-ul, atunci punctul de lucru este considerat implicit 1. (opțional dacă se specifică cif_furn sau den_furn)

den_furn

varchar (30)

Denumirea furnizorul de produse (opțional dacă se specifică id_furn sau cif_furn).

cif_furn

varchar (25)

Codul fiscal / CNP al furnizorului de produse (opțional dacă se specifică id_furn sau den_furn)

pret_achizitie

money

Prețul de achiziție

stas

varchar (15)

S.T.A.S.

dim

varchar (50)

Dimensiunea produsului

val_pct_fidelitate

money

Valoare puncte fidelitate

cod_selectie

varchar (50)

Cod selecție produs

culoare

varchar (50)

Culoarea produsului

lungime

numeric(15,3)

Lungime produs

inaltime

numeric(15,3)

Inaltimea produsului

masa_neta

numeric(15,5)

Masa neta a produsului

error_list

varchar(MAX)

Lista a erorilor apărute la validarea importurilor 

mod_vanzare_easy_retail

tinyint

Pentru mod vanzare easy retail utilizati una din variantele:
0   = Se vinde din stoc
1   = Se produce la vanzare
2   = Se produce unde exista reteta

 validare bit Se va valida sau nu produsul dupa salvare.
 tip_codbar tinyint Pentru tip cod bare utilizati una din variantele:
0 = Fara
1 = Cod nespecificat
2 = Normal Code 39
3 = Full ASCII Code 39
4 = HIBC Code 39
5 = CodaBar
6 = Code 93
7 = Code 128
8 = UCC/EAN 128
9 = Interleaved 2 of 5
10 = PostNET
11 = UPC-A
12 = UPC-E
13 = EAN/JAN-8
14 = EAN/JAN-13
15 = BookLand
16 = MSI/Plessey
17 = PDF-417
18 = Aztec Cod
19 = Data Matrix
20 = MaxiCode
21 = RSS-14
22 = RSS-14 Stacked
23 = RSS-14 Stacked Omnidirectional
24 = RSS Limited
 adaos_minimnumeric(9,4) Procentul adaosului minim permis. Acesta va putea fi utilizat in functiile de avertizare sau pentru blocarea facturarii 
 adaos_maximnumeric(9,4)Procentul adaosului maxim permis. Acesta va putea fi utilizat in functiile de avertizare sau pentru blocarea facturarii 
 tip_articolchar(1) 

Tipul articolului, avand una dintre valorile:

(necompletat) = Articol obisnuit

C = Serviciu de cazare
T = Taxa hoteliera
D = Masa inclusa
1 = Bacsis
B = Serviciu aferent bunurilor
F = Case de marcat fiscale
R = Ambalaj returnabil
V = Retur avans
W = Discount
E = Produs electronic (online)
M = Constructii noi
P = Meniu catering
L = Serviciu tranzit vamal
I = Serviciu transport international
G = Bun/serviciu scutit cu drept de deducere (C.F. art. 294 alin. (5) lit. a) si b))
H = Bun/serviciu scutit cu drept de deducere (C.F. art. 294 alin. (5) lit. c) si d))

Tabel 44. Date import produse



Exemplu de import în format Json

{

       "parametri" :

                 {

                     "id_importex" : "API20211104141925",

                     "manage_existing" : 0,

                     "single_tran" : 1

                 },

      "linii": {

                   "id_produs": "66629",

                   "tip": "N",

                   "cod_extern": "2635364",

                   "denumire": "Pantofi dama",

                   "descriere": "",

                   "um": "BUC",

                   "um2": "",

                   "conv_um2": "0.00000",

                   "den_brand": "",

                   "volum": "0.000",

                   "greutate": "1.000",

                   "ambalare": "0.00",

                   "garantie": "0",

                   "densitate": "0.0000",

                   "latime": "0.000",

                   "valoric": "0",

                   "locație": "",

                   "cod_echiv_furnizor": "",

                   "observatii": "",

                   "cod_tara_origine": "RO",

                   "cod_nc8": "0",

                   "spec_tip": "TXT",

                   "spec_descriere": "",

                   "spec_instalare": "",

                   "spec_utilizare": "",

                   "id_furn": "",

                   "cif_furn": "",

                   "den_furn": "Aldo SRL",

                   "pret_achizitie": "300.0000",

                   "stas": "",

                   "dim": "",

                   "culoare": "negre",

                   "val_pct_fidelitate": "0.0000",

                   "cod_selectie": "",

                   "errorlist": "",

                   "status": "",

                   "validare" : 1

         }

}


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

Exemplu de obiect Json folosit pentru apel:

{

"id_importex" : "NX20180911150146"

}