Import artikelen
Importeer artikelen voor eigen assortiment of als extern assortiment van uw leverancier.
Let op:
De im- en exportmodule is benodigd; een importprofiel dient eenmalig door de Helpdesk van Care4iT ingericht te worden.
Neem gerust contact met ons op voor verdere uitleg of voor het bespreken van oplossingen op maat.
Lees de volgende hoofdstukken voor meer informatie:
- Ondersteunde formaten
- Opties en filters
- Specificaties van Exceldocument
- Specificaties van XML-document
Ondersteunde formaten
De volgende formaten worden ondersteund:
Opties en filters
De volgende opties en filters zijn beschikbaar voor het importeren van de artikelen:
- Type import:
0- Intern voor eigen assortiment1- Extern assortiment (artikelen van leverancier) (standaard)
- Vaste inkoopprijs bijwerken als leverancier de hoofdleverancier is:
true- Ja (standaard)false- Nee
- Artikel automatisch toevoegen aan assortiment als deze valide is:
true- Jafalse- Nee (standaard)
Specificaties van Exceldocument
Het Exceldocument moet aan de volgende voorwaarden voldoen:
- Excel 97-2003-bestand (XLS-extensie) of Excel 2007 of hoger (Open XML)-bestand (XLSX-extensie).
- Het werkblad met de naam
ImportArtikelwordt geïmporteerd. Als deze niet aanwezig is, dan wordt het 1e werkblad ingelezen.
De werkbladen worden automatisch alfabetisch gesorteerd, waardoor het 1e werkblad zal afwijken als er meerdere werkbladen in het Excelbestand aanwezig zijn. Advies is om het werkblad de naam
ImportArtikelte geven.
- Een hoofdregel met kolomnamen op de 1e regel is verplicht.
- De kolomnamen in de hoofdregel zijn vooraf bepaald ofwel er kan geen eigen mapping ingesteld worden (zie ondersteunde kolommen).
- De volgorde van kolommen is niet van belang.
- Het formaat van de celwaarde moet correct zijn: een cel met numerieke waarde mag geen tekst bevatten (en vice versa).
Voorbeeldbestanden
Downloadlinks:
- Excel-voorbeeldbestand:
- Excelsjaboon:
- C4-Products-Template-v1-20211217.xlsx versie 1 (revisie 20211217)
Ondersteunde kolommen van Exceldocument
| Kolomnaam | Alternatieve kolomnnamen | Datatype (formaat) | Verplicht | Toelichting |
|---|---|---|---|---|
| Artikel-basis: | ||||
| Type | N0 | Nee | Type-waarden:1 - Artikel2 - Statiegeldartikel3 - Vrij tekstartikel4 - Tekstregel |
|
| TypeDescription | TypeOmschrijving | N25 | Nee | Type-omschrijving: - Artikel- Statiegeldartikel- Vrij tekstartikel- Tekstregel |
| IsDeposit | IsStatiegeld | Boolean | Nee | Indicatie of artikel een statiegeldartikel is |
| Name | Naam, ArtikelNaam, ProductName | A255 | Ja | Naam van artikel |
| AdditionalDescription | ExtraOmschrijving, Omschrijving, AdditionalDescription, Description | A4096 | Nee | Extra omschrijving |
| IsStockRegistration | IsVoorraadRegistratie, IsVoorraad, IsStock | Boolean | Nee | Voorraadregistratie is actief? |
| IsTrackingAndTracing | Boolean | Nee | Tracking and tracing is actief? | |
| IngredientsDeclaration | IngredientenDeclaratie, Ingredienten, IngredientenTekst, Ingredients, IngredientsText | A8192 | Nee | Ingrediëntendeclaratie: samenvatting van alle ingrediënten, inclusief vermelding van allergenen |
| AllergensDeclaration | AllergenenDeclaratie, Allergenen, AllergenenTekst, Allergens, AllergensText | A8192 | Nee | Allergenendeclaratie: samenvatting van alle allergeenwaarden |
| NutrientsDeclaration | VoedingswaardenDeclaratie, Voedingswaarden, VoedingswaardenTekst, Nutrients, NutrientsText | A8192 | Nee | Voedingswaardendeclaratie: samenvatting van alle voedingswaarden |
| BaseUnit | Basiseenheid | A255 | Nee | Basiseenheid, zoals “Kg” of “Stuk” |
| VatPercent | BtwPercentage, Btw, Vat | N1 | Nee | BTW-tarief ofwel -percentage |
| Manufacturer | Fabrikant | A255 | Nee | Fabrikant |
| Brand | Merk | A255 | Nee | Merk |
| GroupName | GroepNaam, Groep, Group | A255) | Nee | Naam of beschrijving van artikelgroep |
| LocationName | LocatieNaam, Locatie, Location | A255 | Nee | Naam of beschrijving van magazijnlocatie |
| Artikel: | ||||
| Code | ArtikelCode, ProductCode | A25 | Ja | Code of zoeksleutel van artikel |
| Unit | Eenheid, ArtikelEenheid, ProductUnit | A255 | Nee | Eenheid, bijvoorbeeld “Kist” |
| Volume | Inhoud, Content | N5 | Nee | Inhoud, bijvoorbeeld “30” |
| PurchasePrice | Inkoopprijs | N4 | Nee | Standaard inkoopprijs Stuk- of portieprijs, zoals prijs voor 1 stuk of 0,25 kg |
| SalesPrice | Verkoopprijs | N4 | Nee | Standaard verkoopprijs Stuk- of portieprijs, zoals prijs voor 1 stuk of 0,25 kg |
| Barcode | A255 | Nee | Barcode: EAN-8, EAN-13, GTIN, etc. | |
| DeliveryTime | Levertermijn | N0 | Nee | Levertermijn in aantal dagen |
| IsBlockedForPurchase | IsGeblokkeerdInkoop | Boolean | Nee | Is geblokkeerd voor inkoop? |
| IsBlockedForProduction | IsGeblokkeerdProductie | Boolean | Nee | Is geblokkeerd voor productie? |
| IsBlockedForSale | IsGeblokkeerdVerkoop | Boolean | Nee | Is geblokkeerd voor verkoop? |
| Leverancier: | ||||
| SupplierName | LeverancierNaam, Leverancier | A255 | Nee | Leveranciernaam |
| SupplierCreditorNumber | LeverancierCrediteurNummer, CrediteurNummer, CreditorNumber | A50 | Nee | Crediteurnummer van leverancier |
| SupplierProductCode | LeverancierArtikelCode | A25 | Nee | Artikelcode van leverancier |
| SupplierDeliveryTime | LeverancierLevertermijn, Levertijd, DeliveryTime | N0 | Nee | Levertermijn van leverancier in aantal dagen |
Datatypes
| Datatype | Formaat (voorbeeld) | Toelichting |
|---|---|---|
| A | A25 | Alphanumeriek waarde + maximaal aantal tekens |
| Boolean | Indicatie, waarden (niet hoofdlettergevoelig): - true, 1, yes, y, ja, j- false, 0, no, n, nee |
|
| N | N2 | Numerieke waarde + aantal decimalen |
| D | Datum |
Specificaties van XML-document
Voorbeeldbestanden
Downloadlinks:
- XML-voorbeeldbestand:
- XSD-/schemabestand (nog niet beschikbaar)
Structuur van XML-document
| Element | Kardinaliteit | Toelichting |
|---|---|---|
| document | 1 | Root van XML-document |
| ▪ header | 1 | |
| ▪▪ sender | 0 | Verzender |
| ▪▪▪ address | 0 | Bezoekadres |
| ▪▪▪ contact | 0 | Contactinformatie |
| ▪▪ receiver | 0 | Ontvanger |
| ▪ data | 1 | |
| ▪▪ productgroups | 1 | Artikelgroepen |
| ▪▪▪ productgroup | 1..* | Artikelgroep |
| ▪▪▪▪ products | 1 | Artikelen |
| ▪▪▪▪▪ product | 1..* | Artikel |
| ▪▪▪▪▪▪ name | 1 | Artikelnaam en vertalingen 1 |
| ▪▪▪▪▪▪ allergens | 0..1 | Allergenen |
| ▪▪▪▪▪▪ nutrients | 0..1 | Voedingswaarden |
| ▪▪▪▪▪▪ composition | 1 | Samenstelling |
| ▪▪▪▪▪▪ additionalproperties | 0..1 | Extra eigenschappen |
| ▪▪▪▪▪▪ prices | 0..1 | Relatiespecifieke prijzen 2 |
Structuur - Header
| Element | Attributen | Datatype (formaat) | Kardinaliteit | Toelichting |
|---|---|---|---|---|
| header | xs:element | 1 | ||
| ▪ datetimecreatedutc | xs:dateTime | 1 | Aanmaakdatum en -tijd van document | |
| ▪ referencenumber | xs:string | 1 | Unieke referentie naar document | |
| ▪ documenttype | xs:string | 1 | Documenttypes: - PRODUCTS - RELATIONWITHPRODUCTS - RELATIONS - PRICES |
|
| ▪ version | xs:unsignedByte | 1 | Schemaversie van documenttype | |
| ▪ sender | xs:element | 0..1 | Bevat gegevens van verzender | |
| ▪▪ name | xs:string | 0..1 | Bedrijfsnaam | |
| ▪▪ vatnumber | xs:string | 0..1 | BTW-nummer | |
| ▪▪ cocnumber | xs:string | 0..1 | Kamer van Koophandel-nummer | |
| ▪▪ connectid | xs:string | 0..1 | Verbindingssleutel voor communicatie via B2B Connect API | |
| ▪▪ address | xs:element | 0..1 | Bezoekadres | |
| ▪▪▪ streetname | xs:string | 0..1 | Straatnaam en huisnummer | |
| ▪▪▪ cityname | xs:string | 0..1 | Woonplaats | |
| ▪▪▪ postalzone | xs:string | 0..1 | Postcode | |
| ▪▪▪ country | xs:string | 0..1 | Land | |
| ▪▪▪ | code | xs:string | 1 | Landcode van land |
| ▪▪▪ gs1gln | xs:string | 0..1 | GS1 adrescode (GLN) | |
| ▪▪ contact | xs:element | 0..1 | Contactgegevens van verzender | |
| ▪▪▪ phone | xs:string | 0..1 | Telefoonnummer | |
| xs:string | 0..1 | E-mailadres | ||
| ▪▪▪ website | xs:string | 0..1 | Website | |
| ▪ receiver | xs:element | 0..1 | Bevat gegevens van ontvanger | |
| ▪▪ idrelation | xs:string | 0..1 | UUID van relatie | |
| ▪▪ code | xs:string | 0..1 | Code of zoeksleutel van relatie | |
| ▪▪ name | xs:string | 0..1 | Bedrijfsnaam | |
| ▪▪ creditornumber | xs:string | 0..1 | Crediteurnummer | |
| ▪▪ debtornumber | xs:string | 0..1 | Debiteurnummer | |
| ▪▪ vatnumber | xs:string | 0..1 | BTW-nummer | |
| ▪▪ cocnumber | xs:string | 0..1 | Kamer van Koophandel-nummer | |
| ▪▪ gs1gln | xs:string | 0..1 | GS1 adrescode (GLN) | |
| ▪▪ connectid | xs:string | 0..1 | Verbindingssleutel voor communicatie via B2B Connect API |
Structuur - Data
| Element | Attributen | Datatype (formaat) | Kardinaliteit | Toelichting |
|---|---|---|---|---|
| data | xs:element | 1 | ||
| ▪ productgroups | xs:element | 1 | Artikelgroepen | |
| ▪▪ productgroup | xs:element | 1..* | Artikelgroep | |
| ▪▪▪ idproductgroup | xs:string | 1 | UUID van artikelgroep | |
| ▪▪▪ code | xs:string | 0..1 | Code of zoeksleutel van artikelgroep | |
| ▪▪▪ name | xs:string | 1 | Naam of beschrijving van artikelgroep | |
| ▪▪▪ products | xs:element | 1 | Artikelen | |
| ▪▪▪▪ product | xs:element | 1..* | Artikel | |
| ▪▪▪▪▪ idproduct | xs:string | 1 | UUID van artikel | |
| ▪▪▪▪▪ type | xs:unsignedByte | 1 | Soort: 1 - Artikel 2 - Statiegeldartikel 3 - Vrij tekstartikel 4 - Tekstregel |
|
| ▪▪▪▪▪ typedescription | xs:string | 1 | Soortbeschrijving | |
| ▪▪▪▪▪ code | xs:string | 0..1 | Code of zoeksleutel van artikel | |
| ▪▪▪▪▪ name | xs:element | 1 | Artikelnaam en vertalingen | |
| ▪▪▪▪▪▪ value | xs:string | 1 | Artikelnaam | |
| ▪▪▪▪▪▪ translations | xs:element | 0..1 | Vertalingen van artikelnaam 1 | |
| ▪▪▪▪▪▪▪ translation | xs:element | 1..* | Vertaling van artikelnaam | |
| ▪▪▪▪▪▪▪ | code | xs:string | 1 | Code van taal, zoals “nl-NL” of “en-US” |
| ▪▪▪▪▪ additionaldescription | xs:string | 0..1 | Extra omschrijving | |
| ▪▪▪▪▪ ingredientsdeclaration | xs:string | 0..1 | Ingrediëntendeclaratie | |
| ▪▪▪▪▪ allergens | xs:element | 0..1 | Allergenen | |
| ▪▪▪▪▪▪ | declaration | xs:string | 0..1 | Allergenendeclaratie |
| ▪▪▪▪▪▪ allergen | xs:element | 0..* | Allergeenwaarde van artikel | |
| ▪▪▪▪▪▪▪ idallergen | xs:string | 1 | UUID van allergeen | |
| ▪▪▪▪▪▪▪ name | xs:string | 1 | Allergeennaam | |
| ▪▪▪▪▪▪▪ nameshort | xs:string | 0..1 | Korte allergeennaam | |
| ▪▪▪▪▪▪▪ extcode | xs:string | 0..1 | Externe code van allergeen | |
| ▪▪▪▪▪▪▪ value | xs:unsignedByte | 1 | Waarden: 1 - Bevat 2 - Onbekend 3 - Kan bevatten 4 - Bevat niet |
|
| ▪▪▪▪▪ nutrients | xs:element | 0..1 | Voedingswaarden | |
| ▪▪▪▪▪▪ | declaration | xs:string | 0..1 | Voedingswaardendeclaratie |
| ▪▪▪▪▪▪ nutrient | xs:element | 0..* | Voedingswaarde van artikel | |
| ▪▪▪▪▪▪▪ idnutrient | xs:string | 1 | UUID van voedingswaarde | |
| ▪▪▪▪▪▪▪ name | xs:string | 1 | Voedingswaardenaam | |
| ▪▪▪▪▪▪▪ nameshort | xs:string | 0..1 | Korte voedingswaardenaam | |
| ▪▪▪▪▪▪▪ extcode | xs:string | 0..1 | Externe code van voedingswaarde | |
| ▪▪▪▪▪▪▪ unitofmeasurement | xs:string | 1 | Eenheid, zoals “gram” of “ml” | |
| ▪▪▪▪▪▪▪ measurementprecision | xs:unsignedByte | 1 | Nauwkeurigheid/precisie van meting voedingswaarde: 0 - Circa / Ca. 1 - Exact 2 - Minder dan 3 - Afwezig in |
|
| ▪▪▪▪▪▪▪ value | xs:decimal | 1 | Waarde | |
| ▪▪▪▪▪ composition | xs:element | 1 | Samenstelling van artikel | |
| ▪▪▪▪▪▪ | summary | xs:string | 1 | Samenvatting van samenstelling. Voorbeelden: - Kg - 2 Doos á 30 Stuk - 0,25 Kg - Zak á 1,50 Kg |
| ▪▪▪▪▪▪ value | xs:decimal | 1 | Aantal, bijvoorbeeld “2” | |
| ▪▪▪▪▪▪ valueuom | xs:string | 1 | Eenheid, bijvoorbeeld “Doos” | |
| ▪▪▪▪▪▪ content | xs:decimal | 1 | Inhoud, bijvoorbeeld “30” | |
| ▪▪▪▪▪▪ contentuom | xs:string | 1 | Basiseenheid, bijvoorbeeld “Stuk” | |
| ▪▪▪▪▪▪ isbaseuom | xs:boolean | 1 | Is samenstelling de basiseenheid? | |
| ▪▪▪▪▪▪ isweightuom | xs:boolean | 1 | Is samenstelling een gewichtseenheid? | |
| ▪▪▪▪▪ additionalproperties | xs:element | 0..1 | Extra eigenschappen van artikel | |
| ▪▪▪▪▪▪ manufacturer | xs:string | 0..1 | Fabrikant | |
| ▪▪▪▪▪▪ brand | xs:string | 0..1 | Merk | |
| ▪▪▪▪▪▪ barcode | xs:string | 0..1 | Barcode: EAN-8, EAN-13, GTIN, etc. | |
| ▪▪▪▪▪▪ package | xs:element | 0..1 | Verpakkingsinformatie | |
| ▪▪▪▪▪▪▪ size | xs:element | 0..1 | Afmeting | |
| ▪▪▪▪▪▪▪▪ height | xs:decimal | 0..1 | Hoogte | |
| ▪▪▪▪▪▪▪▪ width | xs:decimal | 0..1 | Breedte | |
| ▪▪▪▪▪▪▪▪ depth | xs:decimal | 0..1 | Diepte | |
| ▪▪▪▪▪▪▪▪ valueuom | xs:string | 0..1 | Maateenheid, zoals “cm” of “meter” | |
| ▪▪▪▪▪▪▪ weight | xs:element | 0..1 | Gewicht | |
| ▪▪▪▪▪▪▪▪ value | xs:decimal | 0..1 | Gewichtswaarde | |
| ▪▪▪▪▪▪▪▪ valueuom | xs:string | 0..1 | Maateenheid, zoals “kg” | |
| ▪▪▪▪▪▪▪ content | xs:element | 0..1 | Inhoud | |
| ▪▪▪▪▪▪▪▪ value | xs:decimal | 0..1 | Inhoudswaarde | |
| ▪▪▪▪▪▪▪▪ valueuom | xs:string | 0..1 | Maateenheid, zoals “kg” of “liter” | |
| ▪▪▪▪▪▪ tareweight | xs:element | 0..1 | Tarragewicht ofwel gewicht van verpakking zonder artikel | |
| ▪▪▪▪▪▪▪ value | xs:decimal | 0..1 | Tarragewichtswaarde | |
| ▪▪▪▪▪▪▪ valueuom | xs:string | 0..1 | Maateenheid, zoals “kg” of “gram” | |
| ▪▪▪▪▪▪ storagetemperature | xs:element | 0..1 | Temperatuur bewaaradvies | |
| ▪▪▪▪▪▪▪ value | xs:decimal | 0..1 | Waarde | |
| ▪▪▪▪▪▪▪ valueuom | xs:string | 0..1 | Eenheid, zoals “celsius” | |
| ▪▪▪▪▪▪ shelflife | xs:element | 0..1 | Houdbaarheid van artikel | |
| ▪▪▪▪▪▪▪ value | xs:decimal | 0..1 | Waarde | |
| ▪▪▪▪▪▪▪ valueuom | xs:string | 0..1 | Eenheid, zoals “dag” | |
| ▪▪▪▪▪▪ deliverytime | xs:element | 0..1 | Levertermijn van artikel | |
| ▪▪▪▪▪▪▪ value | xs:decimal | 0..1 | Waarde | |
| ▪▪▪▪▪▪▪ valueuom | xs:string | 0..1 | Eenheid, zoals “dag” | |
| ▪▪▪▪▪ defaultpurchaseprice | xs:decimal | 1 | Standaard inkoopprijs 2 Bijvoorbeeld portieprijs, zoals 0,25 Kg |
|
| ▪▪▪▪▪ defaultpurchasepricebase | xs:decimal | 1 | Standaard inkoopprijs in basiseenheid 2 Bijvoorbeeld kiloprijs, zoals 1 Kg |
|
| ▪▪▪▪▪ purchaseprice | xs:decimal | 1 | Inkoopprijs 3 | |
| ▪▪▪▪▪ purchasepricebase | xs:decimal | 1 | Inkoopprijs in basiseenheid 3 | |
| ▪▪▪▪▪ defaultsalesprice | xs:decimal | 1 | Standaard verkoopprijs 2 Bijvoorbeeld portieprijs, zoals 0,25 Kg |
|
| ▪▪▪▪▪ defaultsalespricebase | xs:decimal | 1 | Standaard verkoopprijs in basiseenheid 2 Bijvoorbeeld kiloprijs, zoals 1 Kg |
|
| ▪▪▪▪▪ salesprice | xs:decimal | 1 | Verkoopprijs 3 | |
| ▪▪▪▪▪ salespricebase | xs:decimal | 1 | Verkoopprijs in basiseenheid 3 | |
| ▪▪▪▪▪ vatpercent | xs:decimal | 1 | BTW-percentage | |
| ▪▪▪▪▪ isblockedforpurchase | xs:boolean | 1 | Is geblokkeerd voor inkoop? | |
| ▪▪▪▪▪ isblockedforproduction | xs:boolean | 1 | Is geblokkeerd voor productie? | |
| ▪▪▪▪▪ isblockedforsale | xs:boolean | 1 | Is geblokkeerd voor verkoop? | |
| ▪▪▪▪▪ prices | xs:element | 0..1 | Relatiespecifieke prijzen 2 | |
| ▪▪▪▪▪▪ purchase | xs:element | 0..1 | Prijzen per leverancier | |
| ▪▪▪▪▪▪ | default | xs:decimal | 1 | Standaard inkoopprijs Bijvoorbeeld portieprijs, zoals 0,25 Kg |
| ▪▪▪▪▪▪▪ relation | xs:element | 1..* | Prijs van leverancier | |
| ▪▪▪▪▪▪▪ | idrelation | xs:string | 1 | UUID van relatie |
| ▪▪▪▪▪▪▪ | code | xs:string | 1 | Code of zoeksleutel van relatie |
| ▪▪▪▪▪▪▪ | name | xs:string | 1 | Bedrijfsnaam |
| ▪▪▪▪▪▪▪ | creditornumber | xs:string | 0..1 | Crediteurnummer |
| ▪▪▪▪▪▪▪ | gs1gln | xs:string | 1 | GS1 adrescode (GLN) |
| ▪▪▪▪▪▪ sales | xs:element | 0..1 | Prijzen per klant | |
| ▪▪▪▪▪▪ | default | xs:decimal | 1 | Standaard verkoopprijs Bijvoorbeeld portieprijs, zoals 0,25 Kg |
| ▪▪▪▪▪▪▪ relation | xs:element | 1..* | Prijs van klant | |
| ▪▪▪▪▪▪▪ | idrelation | xs:string | 1 | UUID van relatie |
| ▪▪▪▪▪▪▪ | code | xs:string | 1 | Code of zoeksleutel van relatie |
| ▪▪▪▪▪▪▪ | name | xs:string | 1 | Bedrijfsnaam |
| ▪▪▪▪▪▪▪ | debtornumber | xs:string | 1 | Debiteurnummer |
| ▪▪▪▪▪▪▪ | gs1gln | xs:string | 1 | GS1 adrescode (GLN) |