UBL Verkoopfactuur
- 1 Inleiding
- 2 Definitie UBL selfbilling factuur
- 2.1 Invoice
- 2.2 Document referentie
- 2.3 Leverancier
- 2.3.1 Postadres
- 2.3.2 BTW schema
- 2.3.3 Contactgegevens
- 2.4 Afnemer
- 2.4.1 Factuuradres
- 2.4.2 BTW schema
- 2.5 Afleveradres
- 2.6 Betalingsgegevens
- 2.7 BTW totalen
- 2.8 Factuurtotaal
- 2.9 Factuurregel
- 2.9.1 Orderregelreferentie
- 2.9.2 Levering
- 2.9.3 Korting
- 2.9.4 BTW totalen factuurregel
- 2.9.5 Gefactureerde item
- 2.9.6 Consumentenprijs
- 3 Voorbeeld van een verkoop factuur
- 4 Kanalen om de elektronische factuur te ontvangen
- 4.1 CB online
- 4.2 FTP
- 4.2.1 Voorbeeld
- 4.2.2 Toelichting naamgeving factuurbestanden
- 4.2.3 Algemene informatie FTP account
- 4.2.4
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 |