ItemCharge

Short description

The ERP Cache Item Charge interface facilitates the upload of charges into the ERP Cache.

These can then be used to determine e.g. deposit fees in the shop.

Delivery method

Update Frequency: Batch at least once a day Incremental or complete set: Incremental

Filetype: Zipped XML

Filename: [SHOPNAME]_ErpCache_ItemCharge_[INDEXNUMBER](_[SUBNUMBER]).xml Transport: over FTPS, FTPS Vendisto server hosted by INTEGRACE, file will be placed on FTPS server by ERP party.

Location within FTP root: \ErpCache\

Structure XML

<?xml version="1.0" encoding="utf-8"?>
<Import>
  <ImportSettings>
    <Importer>ErpCache_ItemCharge</Importer>
    <Version>1.0</Version>
  </ImportSettings>
  <Charges>
    <Charge Code="" Type="DisposalFee" Category=""> <!-- Type: "Deposit" or "DisposalFee" -->
      <Title></Title>
      <CountryCodes>
        <Code></Code> <!-- ISO 3166-1 alpha-2 country code -->
      </CountryCodes>
      <Items>
        <Item Code="" Currency=""> <!-- ISO 4217 currency -->
          <VatPercentage></VatPercentage>
          <TotalAmountExclVat></TotalAmountExclVat>
        </Item>
      </Items>
    </Charge>
  </Charges>
</Import>

Type definition

Charge

Node/Attribute	Description	Required
Code (string)	The identifier of the charge
Type (enum)	Either "Deposit" or "DisposalFee"
Category (string, nullable)	If the charge category name is set, it overrides the default cost line categorization name and grouping in the shop's basket.
Title (string)	The title or description of the charge
CountryCodes (string[], ISO 3166-1 alpha-2)	Determines whether a charge applies, based on the debtor’s invoice address country code. If no country codes are specified, the charge always applies.

Item

Node/Attribute	Description	Required
Code (string)	The product number
Currency (string, ISO 4217)	Currency
VatPercentage (decimal, nullable)	VAT percentage (e.g. 21)
TotalAmountExclVat (decimal, nullable)	The total costs excluding VAT of the charge / product