Import artikelen

Importeer artikelen voor eigen assortiment of als extern assortiment van je 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
• Verwerking van gegevens
• Specificaties van Exceldocument
• Specificaties van XML-document

Ondersteunde formaten

De volgende formaten worden ondersteund:

• Excel 97-2003 (XLS) en 2007 of hoger (XLSX)
• XML

Opties en filters

De volgende opties en filters zijn beschikbaar voor het importeren van de artikelen:

1. Type import:
   • 0 - Intern voor eigen assortiment
   • 1 - Extern assortiment (artikelen van leverancier) (standaard)
2. Vaste inkoopprijs bijwerken als leverancier de hoofdleverancier is:
   • true - Ja (standaard)
   • false - Nee
3. Artikel automatisch toevoegen aan assortiment als deze valide is:
   • true - Ja
   • false - Nee (standaard)
4. Status van inkoop- en/of verkoopeenheid bijwerken als leverancier de hoofdleverancier is. Tel de waarden op, bijvoorbeeld 7 = 1 + 2 + 4 (standaard):
   • 0 - Nee
   • 1 - Inkoopeenheid bijwerken
   • 2 - Verkoopeenheid bijwerken
   • 4 - Extern artikel is vereist

Verwerking van gegevens

Nieuwe artikelen

Een nieuw artikel wordt automatisch aan het assortiment toegevoegd als het valide is en de optie “Artikel automatisch toevoegen aan assortiment als deze valide is” aanstaat. Staat deze optie uit, dan voeg je het artikel zelf toe:

• Type import 0: met de menuknop Artikelen toevoegen… in het importvenster.
• Type import 1: met de menuknop Nieuw… > Extern assortiment… in de module Artikel.

Bestaande artikelen

Artikelen die eerder met deze import zijn toegevoegd, worden als volgt bijgewerkt:

• Type import 0: bestaande artikelen worden niet bijgewerkt.
• Type import 1, extern artikel: het artikel wordt bijgewerkt. Of de naam en extra omschrijving worden bijgewerkt, stel je per artikel in. Met optie 4 kan ook de status van het artikel worden bijgewerkt.
• Type import 1, artikel is inmiddels eigen assortiment: alleen de vaste inkoopprijs wordt bijgewerkt, als de leverancier de hoofdleverancier is en de optie “Vaste inkoopprijs bijwerken als leverancier de hoofdleverancier is” aanstaat.

Allergenen en voedingswaarden

Allergenen en voedingswaarden worden alleen als declaratietekst ingelezen. Afzonderlijke allergeen- en voedingswaarden worden niet bij het artikel opgeslagen en tellen dus niet mee in de berekening van voedingswaarden bij recepturen.

Prijzen en vertalingen

Relatiespecifieke prijzen en vertalingen in een XML-document worden niet ingelezen. Prijzen importeer je via Import prijzen.

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 ImportArtikel wordt 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 ImportArtikel te 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:
  • [1]: C4-Products-Example-v1-20211217.xlsx
• 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 - Artikel 2 - Statiegeldartikel 3 - Vrij tekstartikel 4 - 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:
  • [1] C4-Products-Example-v2-20201029.xml
• XSD-schemabestand (laatste versie):
  • C4-Products-v2-20261106.xsd versie 2 (revisie 20261106)

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
▪▪▪▪▪▪ allergens	0..1	Allergenen
▪▪▪▪▪▪ nutrients	0..1	Voedingswaarden
▪▪▪▪▪▪ composition	1	Samenstelling
▪▪▪▪▪▪ additionalproperties	0..1	Extra eigenschappen

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
▪ 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
▪▪▪ email		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 1
▪▪▪▪▪ 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 1
▪▪▪▪▪▪ value		xs:string	1	Artikelnaam
▪▪▪▪▪ additionaldescription		xs:string	0..1	Extra omschrijving
▪▪▪▪▪ ingredientsdeclaration		xs:string	0..1	Ingrediëntendeclaratie
▪▪▪▪▪ allergens		xs:element	0..1	Allergenen 1
▪▪▪▪▪▪	declaration	xs:string	0..1	Allergenendeclaratie
▪▪▪▪▪ nutrients		xs:element	0..1	Voedingswaarden 1
▪▪▪▪▪▪	declaration	xs:string	0..1	Voedingswaardendeclaratie
▪▪▪▪▪ 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?