API sincronizare Webshop

⌘K
  1. Home
  2. Docs
  3. Instalare si configurare
  4. API sincronizare Webshop

API sincronizare Webshop

Preluarea in RVX Manager a datelor comenzilor de la clienti plasate in magazinul online se realizeaza printr-un fisier de tip XML.

Mai jos sunt redate specificatiile fisierului XML utilizat pentru sincronizarea sistemului RVX cu webshop-ul.

items

CampExplicatie
WshIdid-ul unic al articolului din baza webshop
Codecodul unic de identificare a articolului din baza RVX
Namedenumirea articolului
SellPriceNetpretul de vanzare fara TVA al articolului
SellPriceTotpretul de vanzare inclusiv TVA al articolului
Brandmarca (producatorul) asociata articolului
Categorycategoria din care face parte articolul
Subcategorysubcategoria din care face parte articolul
Warrantyperioada de garantie a articolului exprimata in numar de luni

partners

CampExplicatie
WshIdid-ul unic al partenerului din baza webshop
Codecodul unic de identificare al partenerului din baza RVX
Namenumele partenerului
AddressStreetadresa sediului social a partenerului (strada, numar)
AddressCitylocalitatea in care este situat sediul social al partenerului
AddressRegionsectorul/judetul in care este situat sediul social al partenerului
AddressCountrytara in care este situat sediul social al partenerului
AddressZipCodecodul postal al adresei
Phonenumarul de telefon al partenerului
Faxnumarul de fax al partenerului
Emailadresa electronica a partenerului

saleorders

CampExplicatie
WshIdid-ul unic al comenzii din baza webshop
Numbernumarul unic al comenzii din baza RVX
Datedata in care este inregistrata comanda de la client
PartnerCodecodul unic de identificare a partenerului pentru care este inregistrata comanda
PartnerNamenumele partenerului pentru care este inregistrata comanda
AddressStreetadresa de livrare specificata de catre partener pentru livrarea comenzii
AddressCityorasul in care se efectueaza livrarea
AddressRegionsectorul/judetul in care se efectueaza livrarea
AddressZipCodecodul postal al adresei de livrare
PaymentTypemodalitatea de plata a comenzii
DeliveryTypemodalitatea de livrare a comenzii
DeliveryNotesobservatii suplimentare privind comanda inregistrata
AgentIdid-ul agentului comercial din baza RVX asociat comenzii
LocationIdid-ul locatiei din baza RVX in care este inregistrata comanda
CenterIdid-ul centrului de cost din baza RVX in care este inregistrata comanda
IsPostedin cazul in care comanda este sigilata in webshop, la importul in RVX in campul IsPosted este setata valoarea 1; in caz contrar, in campul IsPosted este setata valoarea 0 (comanda nu este sigilata/confirmata)

lines

CampExplicatie
WshIdid-ul articolului din baza webshop
ItemCodecodul unic de identificare a articolului din baza RVX
ItemNamedenumirea articolului
PriceBasepretul de vanzare de baza (pretul inainte de aplicarea discount-ului); in cazul in care nu se aplica niciun discount, pretul de baza este acelasi cu pretul de vanzare fara TVA (pretul net)
PriceNetpretul de vanzare fara TVA al articolului
PriceTotpretul de vanzare inclusiv TVA al articolului
Quantitycantitatea articolului comandata
ItemVatvaloarea cotei TVA asociata articolului

Exemplu:

<xml>

<items>
<item WshId=”149582″ Code=”CNR-MPV4CI” Name=”MP3 player Canyon CNR-MPV4CI” SellPriceNet=”38.8537″ SellPriceTot=”48.1786″ Warranty=”24″ Category=”Electronice” Subcategory=”MP3 playere” Brand=”Canyon” ></item>
<item WshId=”8708″ Code=”TAXAVERDE” Name=”KOM Taxa Verde” SellPriceNet=”5.3500″ SellPriceTot=”8.0000″ Warranty=”0″ Category=”” Subcategory=”Produse generice” Brand=”KOM” ></item>
</items>

<partners>
<partner WshId=”3021903″ Code=”PF3021903″ Name=”Pata Valentin” AddressStreet=”” AddressCity=”” AddressRegion=”” AddressCountry=”” AddressZipCode=”” Phone=”” Fax=”” Email=”pata.valentin@yahoo.com”></partner>
</partners>

<saleorders>
<saleorder WshId=”3022265″ Number=”3022265″ Date=”2011-05-30″ PartnerCode=”PF3021903″ PartnerName=”Pata Valentin” AddressStreet=”” AddressCity=”” AddressRegion=”” AddressZipCode=”” PaymentType=”CASH” DeliveryType=”MAGAZIN1″ DeliveryNotes=”” AgentId=”88615″ LocationId=”3″ CenterId=”3″ IsPosted=”1″ >
<lines>
<line WshId=”74134″ ItemCode=”CNR-MPV4CI” PriceBase=”110.76″ PriceTot=”137.35″ Quantity=”1″ ItemName=”MP3 player Canyon CNR-MPV4CI” PriceNet=”110.76″ ItemVat=”24″ ></line>
<line WshId=”74135″ ItemCode=”TAXAVERDE” PriceBase=”5″ PriceTot=”6.2″ Quantity=”1″ ItemName=”Taxa Verde” PriceNet=”5″ ItemVat=”24″ ></line>
</lines>
</saleorder>
</saleorders>

</xml>

Adaugare Factura de vanzare prin Webshop

<sale_invoices>

Denumire

Explicatie

IdId-ul documentului
Number*Numarul documentului
Date*Data documentului
Doctype*Tipul de document
LocationId*Id-ul locatiei
AgentId*Id-ul agentului
CenterId*Id-ul centrului
PartnerCode*Codul unic de identificare a partenerului
PartenerName*Numele partenerului
CurrencyType*Tipul de deviza
CurrencyRate*Curs valutar
ValueNetValoare neta
ValueVatValoare TVA
IsPostedValoare =1 , documentul se va importa sigilat Valoare =0, la import documentul nu este sigilat
RefOrderNumarul comenzii
RefDeliveryNumarul avizului
RefInvoiceNumarul facturii
RefReturnNumarul returului

<lines>

Denumire

Explicatie

ItemIdId-ul articolului
ItemCode*Codul articolului
ItemName*Numele articolului
ItemTaxTaxa articolului
ItemVatProcentul de TVA al articolului
QuantityCantitatea
PriceNetPrețul net
PriceTotPretul total
ValueNetValoarea neta
ValueVatValoare TVA
ValueTotValoare neta + TVA
PriceNetVPretul net in valuta
PriceTotVPretul total in valuta
ValueNetVValoare neta in valuta
ValueVatVValoare TVA in valuta
ValueTotVValoare neta in valuta + TVA in valuta
OrderIdId-ul comenzii
OrderLineIdId-ul liniei comenzii

Campurile marcate cu ” * ” trebuie completate obligatoriu.

Exemplu:

<xml>
<sale_invoices>
<sale_invoice Id=”73″ Number=”321″ Date=”2024-12-12″ DocType=”BON” DocTypeId=”208″ LocationId=”1″ AgentId=”1″ CenterId=”1″ PartnerCode=”27698631″ PartnerName=”FLANCO RETAIL SA” CurrencyType=”RON” CurrencyRate=”1.000000″ ValueNet=”5.00″ ValueVat=”0.95″ IsPosted=”1″ RefOrder=”10″ RefDelivery=”” RefInvoice=”” RefReturn=””>
<lines>
<line ItemId=”26″ ItemCode=”PERE” ItemName=”PERE” ItemTax=”VZ_19″ ItemVat=”19.0000″ Quantity=”1.0000″ PriceNet=”5.0000″ PriceTot=”5.9500″ ValueNet=”5.00″ ValueVat=”0.95″ ValueTot=”5.95″ PriceNetV=”5.0000″ PriceTotV=”5.9500″ ValueNetV=”5.00″ ValueVatV=”0.95″ ValueTotV=”5.95″ OrderId=”” OrderLineId=”” />
</lines>
</sale_invoice>
</sale_invoices>
</xml>

Adaugare Aviz de transfer prin Webshop

<stock_transfers>

Denumire

Explicatie

IdId-ul documentului
NumberNumarul documentului
DateData la care este inregistrat documentul
LocationId*Id-ul locatiei
DestinationId*Id-ul destinatiei
IsPostedValoare =1 , documentul se va importa sigilat Valoare =0, la import documentul nu este sigilat

<lines>

Denumire

Explicatie

ItemCode*Codul articolului
QuantityCantitatea

Campurile marcate cu ” * ” trebuie completate obligatoriu.

Exemplu:
<xml>
<stock_transfers>
<stock_transfer Number=”123″ Date=”2024-12-12″ LocationId=”1″ DestinationId=”0″ IsPosted=”1″>
<lines>
<line ItemCode=”CAPSUNA” Quantity=”2″/>
</lines>
</stock_transfer>
</stock_transfers>
</xml>