Importul produselor
Apel API pentru import produse:
http://{ip}:{port}/api/v1/import/produse
Import produse
| Câmp | Tip | Descriere |
|---|---|---|
| id_importex | varchar (25) | ID pentru identificarea unui lot de documente importate (util, de ex., pentru ștergerea in bloc a unui lot de documente importate) |
| 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 | varchar (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 |
Exemplu de import in format Json
{
"parametri" :
{
"id_importex" : "API20211104141925",
"manage_existing" : 0,
"updated_columns" : null,
"exec_type" :0,
"return_errorlist" : 0,
"single_tran" : true
},
"linii": {
"id_intern": "",
"id_produs": "66629",
"tip": "N",
"cod_extern": "2635364",
"denumire": "Pantofi dama",
"descriere": "",
"um": "BUC",
"um2": "",
"conv_um2": "0.00000",
"id_clasa": "",
"den_clasa": "",
"id_subclasa": "",
"den_subclasa": "",
"id_brand": "",
"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": ""
}
}
Pentru anularea importului se utilizeaza: http://{ip}:{port}/api/v1/import/produse_anulare
Exemplu de obiect Json folosit pentru apel:
{
"id_importex" : "NX20180911150146"
}