UBL Verkoopfactuur
Zoekadvies
Zoeken kan het best vanuit de inhoudsopgave op hoofd- en sub-pagina of door gebruik te maken van de functietoets F3 of CTRL + F op de betreffende pagina en niet het zoekveld rechts bovenaan in het CB Wiki scherm (zie onderstaande schermprint). Het document is opgebouwd uit diverse componenten, bij zoeken via het zoekveld wordt er gezocht in de componenten database en verlaat u het document en daarmee ook het overzicht op de structuur van de gebruikershandleiding en berichtdefinitie.
Inleiding
Voor het kenbaar maken van elektronische facturen maakt CB gebruik van de Unified Business Language standaard.
Dit document is gebaseerd op versie 2.0 van Unified Business Language, 12 december 2006 (http://docs.oasis-open.org/ubl/os-UBL-2.0).
Gebruik van dit document
Een standaard UBL factuur is opgedeeld in composites. Een composite is een groepering van verwante elementen. Een composite kan ook andere, onderliggende composites bevatten. Dit document volgt de groepering van verwante velden en composites zoals beschreven in UBL versie 2.0, 12 cecember 2006.
Voor elk besproken veld (data element) van het bestand worden in een tabel volgende punten aangegeven:
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Data element |
|
|
|
|
Composite |
|
|
|
|
Element | De logische naam voor het Data element of de Composite | |
UBL element | Naam van het Data element of de Composite zoals gebruikt binnen het bericht | |
Attribuut | Naam en waarde van attribuut zoals gebruikt binnen het UBL element | |
Cardinaliteit | Hier wordt aangegeven of een Data element of Composite verplicht is en hoe vaak deze mag voorkomen. | |
0..1 | Optioneel en mag maximaal één keer voorkomen | |
0..n | Optioneel en mag maximaal meerdere keren voorkomen | |
1..1 | Verplicht en mag maximaal één keer voorkomen | |
1..n | Verplicht en mag maximaal meerdere keren voorkomen | |
Voorbeeld | Bevat een voorbeeld waarde voor het Data element | |
Opmerking | Bevat eventueel toelichtende opmerkingen bij het Data element of de Composite zoals bijvoorbeeld het formaat |
Niet elk Data element of Composite moet worden opgenomen in de UBL factuur. Optionele Data elementen en Composites welke niet door CB gebruikt worden zijn niet opgenomen in deze definitie.
In de tabel worden Data elementen in een witte rij weergegeven. Composites worden in een gearceerde rij weergegeven te teken dat deze Composite later verder wordt uitgewerkt in Data elementen en eventueel geneste Composites. De naam van de Composite is een hyperlink naar de verdere uitwerking ervan.
Uitgangspunten
CB volgt de UBL standaard volledig, hetgeen betekent dat alle verplichte velden volgens de UBL standaard ook overgenomen worden.
Ondersteunde processen
Dit document beschrijft de berichtdefinities voor het volgende proces:
- Het kenbaar maken van een verkoopfactuur
Definitie UBL selfbilling factuur
Voor het kenbaar maken van de verkoopfactuur wordt gebruikt gemaakt van het UBL documenttype “Invoice”.
Invoice
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
UBL versienummer | cbc:UBLVersionID | 0..1 | 2.0 | |
Factuurnummer | cbc:ID | 1..1 | 80001234 | |
Kopie Indicator | cbc:CopyIndicator | 0..1 | False | De waarde hiervan is altijd false |
Factuurdatum | cbc:IssueDate | 1..1 | 2012-06-22 | Formaat YYYY-MM-DD |
Factuurtype | cbc:InvoiceTypeCode | 0..1 | D | D = Debet / C = Credit |
Valuta | cbc:DocumentCurrencyCode | 0..1 | EUR | |
Aantal factuurregels | cbc:LineCountNumeric | 0..1 | 1 | |
Document referentie | cac:BillingReference/ | 0..n | ||
Leverancier | cac:AccountingSupplierParty/ | 1..1 | ||
Afnemer | cac:AccountingCustomerParty/ | 1..1 | ||
Afleveradres | cac:Delivery/ | 0..n | ||
Betalingsgegevens | cac:PaymentMeans/ | 0..n | ||
BTW totalen | cac:TaxTotal/ | 0..1 | ||
Factuurtotaal | cac:LegalMonetaryTotal/ | 1..1 | ||
Factuurregel | cac:InvoiceLine/ | 1..n |
Document referentie
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
PDF referentie | cac:InvoiceDocumentReference/cbc:ID | 1..1 | 7000002_CBF_DV_201206_80001234.pdf | Verwijzing naar het leesbare PDF document waarin deze factuur is opgenomen |
Leverancier
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
KvK nummer | cac:Party/ cac:PartyIdentification/ cbc:ID | 1..1 | 30276460 | |
Naam | cac:Party/ cac:PartyName/ cbc:Name | 1..1 | CB Facturatie B.V. | Naam van de facturerende partij |
Postadres | cac:Party/cac:PostalAddress/ | 1..1 | Postadres facturerende partij | |
BTW schema | cac:Party/cac:PartyTaxScheme/ | 0..1 | BTW schema facturerende partij | |
Contactgegevens | cac:AccountingContact/ | 0..1 | Contactgegevens facturerende partij |
Postadres
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Postbus | cac:Party/ cac:PostalAddress/ cbc:Postbox | 0..1 | 125 | |
Plaats | cac:Party/ cac:PostalAddress/ cbc:CityName | 0..1 | Culemborg | |
Postcode | cac:Party/ cac:PostalAddress/ cbc:PostalZone | 0..1 | 4100 AC | |
Landcode | cac:Party/ cac:PostalAddress/ cac:Country/cbc:IdentificationCode | 0..1 | NL | |
Land | cac:Party/ cac:PostalAddress/ cac:Country/cbc:Name | 0..1 | Nederland |
BTW schema
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
BTW Nummer | cac:Party/ cac:PartyTaxScheme/ cbc:CompanyID | 0..1 | NL821679648B01 | |
BTW schema naam | cac:Party/ cac:PartyTaxScheme/ cac:TaxScheme/cbc:Name | 1..1 | NL VAT |
Contactgegevens
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Telefoonnummer | cac:AccountingContact/cbc:Telephone | 0..1 | 0345-475888 | |
Faxnummer | cac:AccountingContact/cbc:Telefax | 0..1 | 0345-475898 | |
cac:AccountingContact/cbc:ElectronicMail | 0..1 | Dit element is alleen gevuld in geval van facturatie door eBoekhuis b.v. |
Afnemer
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Relatie ID Afnemer | cbc:SupplierAssignedAccountID | 1..1 | 7000002 | Relatie ID waarmee de afnemer binnen CB geïdentificeerd wordt |
Afnemernaam | cac:Party/cac:PartyName/cbc:Name | 1..1 | XYZ, Literaire Boekhandel | |
Factuuradres | cac:Party/ cac:PostalAddress/ | 0..1 | Factuuradres | |
BTW schema | cac:Party/ cac:PartyTaxScheme/ | 0..1 | BTW schema afnemer |
Factuuradres
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Adres | cac:Party/ cac:PostalAddress/cbc:StreetName | 0..1 | Straatweg 1 | Straat + Huisnummer van het factuuradres |
Ter attentie van | cac:Party/ cac:PostalAddress/cbc:InhouseMail | 0..1 | afdeling crediteuren | Wordt alleen gevuld indien deze van toepassing is bij de betreffende factuur |
Plaats | cac:Party/ cac:PostalAddress/cbc:CityName | 0..1 | Amsterdam | |
Postcode | cac:Party/ cac:PostalAddress/cbc:PostalZone | 0..1 | 1000 AA | |
Landcode | cac:Party/ cac:PostalAddress/ cac:Country/cbc:IdentificationCode | 0..1 | NL | |
Land | cac:Party/ cac:PostalAddress/ cac:Country/cbc:Name | 0..1 | Wordt alleen gevuld wanneer het niet Nederland is |
BTW schema
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
BTW nummer afnemer | cac:Party/ cac:PartyTaxScheme/ cbc:CompanyID | 0..1 | NL807654321B01 | |
BTW schema naam | cac:Party/ cac:PartyTaxScheme/ cac:TaxScheme/cbc:Name | 1..1 | NL VAT | Wordt alleen gevuld als in het vorige element een BTW-nummer is opgenomen Dit is het belastingregime waaronder het BTW nummer van de afnemer valt. |
Afleveradres
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Adres | cac:DeliveryAddress/cbc:StreetName | 0..1 | Straatweg 1 | Straat + Huisnummer van het afleveradres |
Ter attentie van (levering) | cac:DeliveryAddress/cbc:InhouseMail | 0..1 | Dhr. J. Jansen | Wordt alleen gevuld indien deze van toepassing was bij de betreffende levering |
Plaats | cac:DeliveryAddress/cbc:CityName | 0..1 | Amsterdam | |
Postcode | cac:DeliveryAddress/cbc:PostalZone | 0..1 | 1000 AA | |
Landcode | cac:DeliveryAddress/ cac:Country/cbc:IdentificationCode | 0..1 | NL | |
Land | cac:DeliveryAddress/ cac:Country/cbc:Name | 0..1 | Wordt alleen gevuld wanneer het niet Nederland is | |
Relatie ID levering | cac:DeliveryParty/cac:PartyIdentification/cbc:ID | 1..1 | 7000002.00 | Dit is een samentrekking van het relatie ID en het stroomnummer van het afleveradres. Standaardwaarde voor stroomnummer is 00. klanten kunnen meerdere stroomnummers hebben (01,02 enz.) om orderstromen aan te sturen naar bv: ander fysiek adres en verschillende afdelingen binnen de winkel. |
Naam relatie | cac:DeliveryParty/cac:PartyName/cbc:Name | 1..1 | XYZ, Literaire Boekhandel |
|
Betalingsgegevens
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Code betaalwijze | cbc:PaymentMeansCode | 1..1 | AI | AI = Automatische Incasso, VD = Door u te voldoen, VR = Door u te verrekenen |
Vervaldatum | cbc:PaymentDueDate | 0..1 | 2012-09-30 | Formaat YYYY-MM-DD |
Omschrijving betaalwijze | cbc:InstructionNote | 0..n | Automatische Incasso | Automatische incasso, Door u te voldoen of Door u zelf te verrekenen |
Bankgegevens facturerende partij | cac:PayeeFinancialAccount/ | 0..1 | Bankgegevens facturerende partij |
Bankgegevens facturerende partij
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
IBAN Banknummer | cbc:ID | 0..1 | NL76RABO0108242927 | IBAN nummer van de facturerende partij |
BIC code bank | cac:FinancialInstitionBranch/cbc:ID | 0..1 | RABONL2U | BIC code van de bank van de facturerende partij |
Naam bank | cac:FinancialInstitionBranch/cbc:Name | 0..1 | Rabobank | Naam van de bank van de facturerende partij |
BTW totalen
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Totaal BTW bedrag | cac:TaxTotal/cbc:TaxAmount currencyID=”EUR” | 0..1 | 3.95 | |
Totalen per BTW percentage | cac:TaxTotal/ cac:TaxSubtotal/ | 0..n | Repeterende groep per BTW % |
Totalen per BTW percentage
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
BTW grondslag | cac:TaxSubtotal/cbc:TaxableAmount currencyID=”EUR” | 0..1 | 65.85 | |
BTW bedrag | cac:TaxSubtotal/cbc:TaxAmount currencyID=”EUR” | 1..1 | 3.95 | |
BTW percentage | cac:TaxSubtotal/cbc:Percent | 0..1 | 6 | |
Wettekst | cac:TaxSubtotal/cac:TaxCategory/cbc:TaxExemptionReason | 0..1 | Exempt intracommunity supply - article 138 of the EC VAT directive | Dit element wordt gevuld als er een specifieke wettekst op de factuur van toepassing is |
BTW schema naam | cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:Name | 1..1 | NL VAT |
Factuurtotaal
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Totaal factuurbedrag excl. BTW | cac:LegalMonetaryTotal/cbc:TaxExclusiveAmount currencyID=”EUR” | 0..1 | 65.85 | |
Totaal factuurbedrag incl. BTW | cac:LegalMonetaryTotal/cbc:PayableAmount currencyID=”EUR” | 1..1 | 69.80 |
Factuurregel
Een factuurregel kan zowel een gefactureerd artikel betreffen als doorbelaste verzendkosten.
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Identificatie van de factuurregel | cac:InvoiceLine/(1..1) cbc:ID | 1..1 | 12345 | |
Factuurregelopmerking | cac:InvoiceLine/(0..1) cbc:Note | 0..1 | Embargo t/m 22-12-2012 | |
Aantal | cac:InvoiceLine/(0..1) cbc:InvoicedQuantity | 0..1 | 5 | |
Netto regelbedrag excl. BTW | cac:InvoiceLine/(1..1) cbc:LineExtensionAmount currencyID=”EUR” | 1..1 | 65.85 | |
Orderregelreferentie | cac:InvoiceLine/(0..n) cac:OrderLineReference/ | 0..n | ||
Levering | cac:InvoiceLine/(0..n) cac:Delivery/ | 0..n | Wordt opgenomen wanneer het een levering door CB betreft | |
Korting | cac:InvoiceLine/(0..n) cac:AllowanceCharge/ | 0..n | ||
BTW totalen factuurregel | cac:InvoiceLine/(0..n) cac:TaxTotal/ | 0..n | ||
Gefactureerde item | cac:InvoiceLine/(1..1) cac:Item/ | 1..1 | ||
Consumentenprijs | cac:InvoiceLine/(0..1) cac:Price/ | 0..1 |
Orderregelreferentie
Deze groep kan binnen een factuurregel meerdere keren voorkomen. Bijvoorbeeld bij de facturatie van e-book leveringen worden e-book leveringen van dezelfde titel met dezelfde condities gesommeerd op één factuurregel. Aan de betreffende factuurregel liggen dus meerdere orders en leveringen ten grondslag.
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
CB factuurregelreferentie | cac:OrderLineReference/cbc:LineID | 1..1 | 57216 | Dit betreft een interne CB regel referentie waarbij een link gelegd kan worden naar een regel in het uitgevoerde opdrachtbericht (UITOPD). |
Afnemer orderreferentie | cac:OrderLineReference/ cac:OrderReference/cbc:ID | 0..1 | 38-9374-0 | Wordt gevuld met de orderregel referentie welke door de afnemer bij het indienen van de opdrachtregel is opgegeven. Wanneer geen afnemer orderregel referentie is opgegeven wordt de afnemer order referentie getoond (mits opgegeven). |
Levering
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Levereenheid | cac:InvoiceLine/ cac:Delivery/cbc:ID | 0..1 | 6071752524 | Nummer van de levereenheid (pakbon) |
Korting
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Toeslag indicatie | cac:AllowanceCharge/cbc:ChargeIndicator | 1..1 | false | Indicatie welke aangeeft dat het om een korting gaat. De waarde “false” geeft altijd aan dat het om een korting gaat. |
Kortingspercentage | cac:AllowanceCharge/cbc:MultiplierFactorNumeric | 0..1 | 0.30 | De korting wordt getoond in decimalen notatie, een korting van 30% wordt dus getoond als “.30”. |
Kortingsbedrag | cac:AllowanceCharge/cbc:Amount currencyID=”EUR” | 1..1 | 28.25 | Het kortingsbedrag excl. BTW |
BTW totalen factuurregel
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Totaal BTW regelbedrag | cac:TaxTotal/cbc:TaxAmount currencyID=”EUR” | 0..1 | 3.95 | |
BTW regeltotalen per BTW percentage | cac:TaxTotal/cac:TaxSubtotal/ | 0..n | Repeterende groep per BTW percentage |
BTW regeltotalen per BTW percentage
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Nettobedrag excl. BTW | cac:TaxSubtotal/cbc:TaxableAmount currencyID=”EUR” | 0..1 | 65.85 | Het netto regelbedrag exclusief BTW waarover het betreffende BTW percentage geheven wordt. |
BTW bedrag | cac:TaxSubtotal/cbc:TaxAmount currencyID=”EUR” | 1..1 | 3.95 | |
BTW percentage | cac:TaxSubtotal/cbc:Percent | 0..1 | 6 | |
Brutoprijs excl. BTW | cac:TaxSubtotal/cbc:PerUnitAmount currencyID=”EUR” | 0..1 | 18.82 | De brutoprijs excl. BTW per artikel voor het betreffende BTW percentage |
BTW schema naam | cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:Name | 1..1 | NL VAT |
Gefactureerde item
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Omschrijving | cbc:Description | 0..n | Auteur*De titel van het boek | Omschrijving van hetgeen gefactureerd wordt. Bij artikelen is de de auteur*titel, bij doorbelaste verzendkosten is dit "VERZENDKOSTEN NAMENS UITGEVER " met een aanduiding van de uitgever |
Identificatie | cac:StandardItemIdentification/cbc:ID | 1..1 | 9780123456789 | Identificatie van hetgeen gefactureerd wordt, het EAN |
Extra elementen | cac:AdditionalItemProperty/ | 0..n | Repeterende groep voor extra elementen | |
Naam extra element | cac:AdditionalItemProperty/cbc:Name | 1..1 | Opdrachttype | |
Waarde extra element | cac:AdditionalItemProperty/cbc:Value | 1..1 | Leveren normale koop |
Voor een aantal elementen die we op willen nemen in de UBL factuur is geen ruimte binnen de standaard definitie. Om deze elementen op te kunnen nemen wordt gebruikt gemaakt van het element AdditionalItemProperty, Deze maakt het mogelijk een naam van een element op te geven en de waarde van het element. Onderstaande tabel geeft een overzicht van extra elementen die we onderkennen.
Naam extra element | Vorbeeld waarde extra element | Opmerking |
Opdrachttype | Leveren normale koop | Dit element is alleen van toepassing bij facturatie door CBF |
Uitgever | ABCD | Naam van de eigenaar(uitgever) van het artikel |
Voorwaarde | DIO | Dit element is alleen van toepassing bij facturatie door CBF. De transactie voorwaarde categorie: Mogelijke waarden: AANB / DIO / DUD / DIG |
Boeksoort | O | Dit element is alleen van toepassing bij facturatie door CBF. Mogelijke waarden: A /O/ S/ W |
Uit nota | Ja | Dit element is alleen van toepassing bij facturatie door CBF. Mogelijke waarden: Ja / Nee |
Consumentenprijs
Element | UBL element | Cardinaliteit | Voorbeeld | Opmerking |
Consumentenprijs | cac:Price/cbc:PriceAmount currencyID=”EUR” | 0..1 | 19.95 | Adviesverkoopprijs incl. Nederlandse BTW |
Voorbeeld van een verkoop factuur
Kanalen om de elektronische factuur te ontvangen
De elektronische factuur wordt altijd in twee formatie uitgereikt, in leesbaar PDF formaat en in het UBL formaat t.b.v. geautomatiseerde verwerking.
Vanaf 1 oktober 2022 is het bedrag op het voorblad van de factuur (Totaal netto excl btw) het totaal van alle niet afgeronde regelbedragen. Dit bedrag is de basis voor de berekening van de btw.
Er zijn twee kanalen beschikbaar via welke een afnemer de elektronische factuur van CB kan ontvangen. Bij CB aangesloten afnemers krijgen de elektronische factuur altijd via CB Online afgeleverd. Een afnemer kan de factuur hiervandaan downloaden en kan daarbij zelf bepalen of de PDF factuur en/of de UBL factuur wordt gebruikt voor verdere verwerking. Voor afnemers die facturen volledig geautomatiseerd willen verwerken is er de mogelijkheid de elektronische facturen via FTP te ontvangen. Beide kanalen worden hieronder verder toegelicht
CB online
In CB Online is een tabblad Facturatie beschikbaar waar een afnemer de PDF en/of de UBL factuur kan downloaden.
FTP
Wanneer een afnemer er voor kiest facturen via FTP te ontvangen krijgt deze per dag via FTP twee ZIP bestanden aangeleverd met daarin alle facturen voor de betreffende afnemer. Het ene ZIP bestand bevat de facturen in PDF formaat, het andere ZIP bestand bevat de facturen in UBL formaat.
De naamgeving van dit ZIP bestand is als volgt:
Naamgeving Zip bestand | <Relatie ID Uitgever>_SELFB_<Formaat>_<JJJJMMDD>.zip |
---|---|
<Relatie ID Afnemer> | Het Relatie ID van de afnemer |
<Formaat> | Het formaat van de facturen (PDF of UBL) |
<JJJJMMDD> | De dag waarop CB de facturen verstrekt (is niet factuurdatum) |
Voorbeeld
Dit voorbeeld bevat de volgende facturen:
- Maandoverzicht eBoekhuis (7000123_EBH_MV_201211_01) met daarin de volgende dagfacturen: 80004321, 80005678 en 80008765
- Creditfactuur eBoekhuis (80001234)
- De volgende dagfacturen van CBF: 10001234, 10001258 en 10001265
Voorbeeld inhoud van de ZIP bestanden met hierboven genoemde verkoopfacturen:
7000123_FACT_PDF_20121201.zip
\7000123_EBH_MV_201211_01.pdf
\7000123_EBH_DV_201211_80001234.pdf
\7000123_CBF_DV_201211_10001234.pdf
\7000123_CBF_DV_201211_10001258.pdf
\7000123_CBF_DV_201211_10001265.pdf
7000123_FACT_UBL_20121201.zip
\7000123_EBH_MV_201211_01_80004321_UBL.xml
\7000123_EBH_MV_201211_01_80005678_UBL.xml
\7000123_EBH_MV_201211_01_80008765_UBL.xml
\7000123_EBH_DV_201211_80001234_UBL.xml
\7000123_CBF_DV_201211_10001234_UBL.xml
\7000123_CBF_DV_201211_10001258_UBL.xml
\7000123_CBF_DV_201211_10001265_UBL.xml
Toelichting naamgeving factuurbestanden
Bij het verstrekken van PDF facturen onderkennen we volgende factuurbestanden:
- Maandoverzicht eBoekhuis
<Relatie ID Afnemer>_EBH_MV_<JJJJMM>_<volgnr>.pdf - Creditfactuur eBoekhuis
<Relatie ID Afnemer>_EBH_DV_<JJJJMM>_<factuurnummer>.pdf - Dagfactuur CB Facturatie
<Relatie ID Afnemer>_CBF_DV_<JJJJMM>_<factuurnummer>.pdf - Maandoverzicht CB Facturatie
<Relatie ID Afnemer>_CBF_MV_<JJJJMM>_<volgnr>.pdf
Bij het verstrekken van XML facturen onderkennen we volgende factuurbestanden:
- Factuur eBoekhuis
<Relatie ID Afnemer>_EBH_MV_<JJJJMM>_<volgnr>_<factuurnummer>_UBL.xml - Creditfactuur eBoekhuis
<Relatie ID Afnemer>_EBH_DV_<JJJJMM>_<factuurnummer>_UBL.xml - Dagfactuur CB Facturatie
<Relatie ID Afnemer>_CBF_DV_<JJJJMM>_<factuurnummer>_UBL.xml - Maandoverzicht CB Facturatie
<Relatie ID Afnemer>_CBF_MV_<JJJJMM>_<volgnr>_<factuurnummer>_UBL.xml
Algemene informatie FTP account
Bestanden worden uitgewisseld middels het FTP(S) protocol. Versleuteling van de berichten op basis van het protocol ftp(e)s (FTP over SSL) is verplicht.
CB ondersteunt op dit moment enkel TLS 1.2, data channels zijn gelimiteerd tot poortrange 41000:42000. Om gebruik te maken van versleuteld ftp, dient de gebruikte ftp cliënt software dit wel te ondersteunen.
Webservices en websites zijn secure zodra daar vertrouwelijke gegevens over gaan.
CB stelt FTPs (SSL encryptie) 'FTP over TLS' verplicht maar staat 'Plain text FTP' nog toe. Met ingang van 1 maart 2025 is 'Plain text FTP' definitief niet meer toegestaan.
Wanneer er gebruik gemaakt wordt van communicatie via FTP wordt er een ftp account op de ftp1.boekhuis.nl server van CB aangemaakt. Via dit account kunnen de bestanden voor CB geplaatst worden en zullen de gewenste bestanden door CB worden klaargezet. De inloggegevens worden toegestuurd na activeren van het account.
Kenmerken FTP account | |||
---|---|---|---|
/Relatie id/ | Home directory | ||
in/ | map voor bestanden van Klant naar CB | Geplaatste bestanden worden door CB direct na binnenkomst verplaatst voor syntactische controle en verdere verwerking. Na plaatsen van het bestand is het niet toegestaan om deze nog te bewerken . Van geplaatste bestanden wordt automatische een ontvangstbevestiging geplaatst in de out map | |
out/ | map voor bestanden van CB naar Klant | Bestanden die gedownload of geopend worden zullen automatisch van de ftp server verwijderd worden. Bestanden die niet worden opgehaald, zal CB na enige tijd verwijderen | |
Aanmaken van directories en sub-directories is niet toegestaan. |
Naamgeving bestand bestaat uit 2 delen, gedeelte voor en na de 'punt' | |
---|---|
voor de 'punt' | bestandsnaam |
na de 'punt' | extensie |
De bestandsnaam mag opgebouwd worden m.b.v. cijfers 0 t/m 9, de letters a t/m z (hoofdletters en/of kleine letters) en de speciale karakters “punt “ (.), dash (-) en underscore (_). Alle andere karakters zoals spatie, trema, &, <, >, {, } etc. zijn niet toegestaan. Voor de extensie is het gebruik van hoofdletters niet toegestaan. |
Connectie met ftp server - Transfer mode | ||
---|---|---|
Frequentie voor inloggen op de ftp server is maximaal 1 keer per 10 minuten. Aan het eind van iedere sessie dient er uitgelogd te worden. Parallelle inlogsessies voor hetzelfde bestand zijn niet toegestaan. | ||
Transfer mode | Voor de verbinding dient gebruik gemaakt te worden van commando PASV (passive mode) | |
Binair | alle bestanden met de extensies '.epub', '.jpg', '.pdf' en '.zip' | |
ASCII | alle overige extensies |