gebruikershandleiding Uitgever UITOPD bericht Informatie over: Uitgevoerde opdrachten bericht Datum: Versie: 1.2

Transcriptie

1 gebruikershandleiding Uitgever UITOPD bericht Informatie over: Uitgevoerde opdrachten bericht Datum: Versie: 1.2

2 Inhoudsopgave 1. Uitgevoerde opdrachten Uitgever Uitgevoerde opdrachten Uitgever UITOPD bericht Levering van de berichten 3 2. FTP account algemene informatie Bestandsnamen Ophalen van bestanden 4 3. Berichtopbouw en berichtdefinitie UITOPD Berichtdefinitie van het UITOPD bericht voor uitgevers Toelichting match UITOPD Correcties in UITOPD Uitgevoerde opdracht versus voorraadstand/goederenbeweging 14

3 1. Uitgevoerde opdrachten Uitgever 1.1. Uitgevoerde opdrachten Uitgever UITOPD bericht Het bericht uitgevoerde opdrachten bevat bij iedere levering alle nieuwe uitgevoerde opdrachten ten opzichte van de voorgaande levering. Dit zijn opdrachten die door CB zijn behandeld en waarvan de opdracht daadwerkelijk is uitgevoerd. Een uitgevoerde opdracht wordt slechts eenmaal via dit bericht teruggemeld Levering van de berichten Uitgaande berichten levert CB in een dagelijks, wekelijkse maandag t/m vrijdag of maandelijkse frequentie. Er worden eventueel lege berichten geleverd: als er geen informatie te zenden is worden alleen de algemene bestandsgegevens gezonden (header en footer). Het bericht Uitgevoerde opdrachten wordt s morgens op uw FTP account klaargezet. De bestanden hebben betrekking op de activiteiten die de voorgaande werkdag week maand zijn uitgevoerd. 2. FTP account algemene informatie Het FTP account heeft de volgende kenmerken; /relatie ID home directory /relatie ID/in/ plaatsing berichten van u aan CB /relatie ID/out/ plaatsing berichten van CB aan u Het is niet toegestaan om zelf directories en subdirectories aan te maken. De frequentie om in te loggen op de server door de klant mag niet vaker zijn dan 1 keer per 10 minuten. Parallelle inlogsessies voor hetzelfde bestand zijn niet toegestaan Bestandsnamen De naamgeving van een bestand bestaat uit twee delen, het gedeelte voor en het gedeelte na de punt; De bestandsnaam, dat wat voor de punt geplaatst is, is het relatie id gevolgd door de letter u, daarna een volgnummer (4 cijfers) en daarna de datum (YYYYMMDD) De extensie, dat wat na de punt geplaatst is, is bij de uitopd.uit Vb: 3

4 2.2. Ophalen van bestanden Bestanden die door u worden opgehaald (gedownload) uit de /relatie ID/out/ directory worden automatisch verwijderd door de FTP server. 3. Berichtopbouw en berichtdefinitie UITOPD 3.1. Berichtdefinitie van het UITOPD bericht voor uitgevers Record type 0: Header informatie Ieder UITOPD bericht begint met dit recordtype. CB-id Attribuut naam Opmerking Format Standaard waarde Toelichting #0001 Record_type Wordt altijd meegegeven n(1) 0 Record type 0 #0002 Bericht_type Wordt altijd meegegeven an(6) UITOPD Soort bericht #0003 Versie_nr Wordt altijd meegegeven an(5) 0809A Versie van het bericht #0004 Verzend_dat Wordt altijd meegegeven n(8) sysdate (yyyymmdd) Datum van verzenden #0005 Verzend_tijd Wordt altijd meegegeven n(4) sysdate (yyyymmddi) Tijdstip van verzenden #0006 Bericht_referentie Wordt altijd meegegeven n(10) De unieke referentie van het bericht. Waarde is gelijk aan de waarde in veld #0006 in de footer informatie. #0007 Acknowledgement_ind Wordt altijd meegegeven n(1) 0 Verzendbevestiging t.b.v. controle CB #0008 Test_ind Wordt altijd meegegeven n(1) 0 Geeft aan of het om een testbericht gaat, enkel de waarde 0 zal voorkomen 4

5 Record type 1: Partij specificatie Recordtype 1 wordt altijd tweemaal opgenomen. Als eerste de gegevens van de afzender van het bericht (altijd CB). De tweede regel bevat de gegevens van de ontvanger van het bericht. CB-id Attribuut naam Opmerking Format Standaard waarde Toelichting #0001 Record_type Wordt altijd meegegeven n(1) 1 Record type 1 #0009 Partij_type Wordt altijd meegegeven an(4) AFZ Geeft aan dat dit de Afzender is van het bericht. #0010 Partij_id Wordt altijd meegegeven n(7) Het 7-cijferig relatie-id waaronder de afzender van het orderbericht bekend is bij CB. #0011 Partij_id_type Wordt altijd meegegeven an(2) CB Geeft het type van de betrokken partij (veld #0010) weer, altijd CB. CB-id Attribuut naam Opmerking Format Standaard waarde Toelichting #0001 Record_type Wordt altijd meegegeven n(1) 1 Record type 1 #0009 Partij_type Wordt altijd meegegeven an(4) ONTV Geeft aan wie de ontvanger is van het bericht #0010 Partij_id Wordt altijd meegegeven n(7) Het 7-cijferig relatie id van de ontvanger van het bericht #0011 Partij_id_type Wordt altijd meegegeven an(2) CB Geeft het type van de betrokken partij (veld #0010) weer, altijd CB. Recordtype2: Transactiegegevens CB-id Attribuut naam Opmerking Format Standaard waarde Toelichting #0001 Record_type Wordt altijd meegegeven n(1) 2 Record type 2 #0903 Valuta_kd Wordt altijd meegegeven an(3) EUR Valutacode #0450 Faktuur_dat Optioneel n(8) (yyyymmdd) #0451 Uitlever_dat Optioneel n(8) (yyyymmdd) Verwachte bezorg/uitleverdatum #0452 Faktuur_nr Optioneel n(9) Factuurdatum van de verkoopfactuur aan de afnemer waarop deze opdracht is gefactureerd. Factuurnummer van de verkoopfactuur aan de afnemer waarop deze opdracht is gefactureerd. 5

6 Recordtype3: Bij transactiebetrokken partijen CB-id Attribuut naam Opmerking Format Standaard waarde Toelichting #0001 Record_type Wordt altijd meegegeven n(1) 3 Recordtype 3 #0009 Partij_type Wordt altijd meegegeven an(4) AFN Geeft aan wie de afnemer is van de uitgevoerde opdracht #0010 Partij_id Wordt altijd meegegeven n(7) Het 7-cijferig relatie id van de ontvanger van het bericht #0011 Partij_id_type Wordt altijd meegegeven an(2) CB Geeft het type van de betrokken partij (veld #0010) weer, altijd CB. #0012 Stroom_nr Optioneel n(2) Standaardwaarde is 0. klanten kunnen meerdere stroomnummers hebben (1,2 enz.) om orderstromen aan te sturen naar bv: ander fysiek adres en verschillende afdelingen binnen de winkel. 6

7 Recordtype 4 Transactieregel Uitgevoerde opdrachtregel informatie Geeft detailinformatie over de uitgevoerde opdrachten CB-id Attribuut naam Opmerking Format Standaard waarde Toelichting #0001 Record_type Wordt altijd meegegeven n(1) 4 Recordtype:4 #0200 EAN_artikel_kd Wordt altijd meegegeven an(13) Het EAN van het artikel #0260 Eigenaar_relatie_id Wordt altijd meegegeven n(7) Het 7 cijferig relatie-id van de eigenaar van het artikel #0403 Eigenaar_opdr_ref. Optioneel an(10) #0404 Afnemer_opdr_ref. Optioneel an(10) #0440 Eigenaar_regel_ref. Optioneel an(10) #0441 Afnemer_regel_ref. Optioneel an(10) Referentie van de opdracht ten behoeve van de eigenaar. indien meegegeven in de opdracht. Referentie van de opdracht ten behoeve van de afnemer/boekverkoper indien meegegeven in de opdracht. Referentie van de opdrachtregel ten behoeve van de eigenaar van het artikel, indien meegegeven in de opdracht. Referentie van de opdrachtregel ten behoeve van de afnemer/boekverkoper indien meegegeven in de opdracht. #0430 Exemp_aant Wordt altijd meegegeven n(6) Het uitgeleverde aantal exemplaren #0431 Transactie_vwc Optioneel an(4) Mogelijke waarde: AANB DIO DUD DIG De transactie voorwaarde categorie: Veelal zal de opdracht worden uitgevoerd onder de Depotvoorwaarden (DUD). Wanneer er kortingsafspraken zijn gemaakt met de uitgeverij kan de order uitgevoerd worden onder uitgeversvoorwaarden (DIO). Bestellingen op nieuwe, te verschijnen, titels worden omgezet naar AANB (aanbiedingsvoorwaarden). e-books worden altijd onder twvc DIG uitgeleverd 7

8 CB-id Attribuut naam Opmerking Format Standaard waarde Toelichting #0433 Verkoop_omz_srt Optioneel an(4) Mogelijke waarde: NORM AANB RAMS PRES Daarnaast kunnen uitgevers zelf een VOS meegeven in de opdracht De VOS is een"verslagleggingstool "die een uitgever kan gebruiken voor zijn verslaglegging. Standaard wordt er aan elk opdrachttype, waarbij een facturering zal plaatsvinden, een VOS toegekend. De uitgever kan, indien hij zelf de order heeft ingediend, een uitgever specifieke VOS meegeven in de opdracht. Deze zal dan in de uitgevoerde opdracht worden meegenomen. Mogelijke waarde: LNORM = NORM (bij TWVC AANB is dat AANB) LPROM = PRES LRAMSJ = RAMS LEBOEK =EBOO Voorbeeld uitgever specifieke VOS is CLUB, ACTI, SPEC... #0401 Opdr_dat Wordt altijd meegegeven n(8) (yyyymmdd) Dit is de ontvangstdatum van de opdracht bij CB #0432 Transactiekorting_pct Optioneel n(5,2) Levering korting van de opdacht. Deze wordt uitsluitend meegegeven indien CB de facturering ook verzorgd van de uitgevoerde opdracht. Dus niet bij opdrachttype VV, LGEENF, LNEIG, LCONS #0901 Consument_verk_prijs Wordt altijd meegegeven n(8,2) Advies verkoopprijs incl BTW ( vaste boekprijs) #0907 Prijs_hoog_btw Optioneel n(9,2) #0911 Btw_bdr Wordt altijd meegegeven n(9,2) #0902 Retail_prijs Wordt altijd meegegeven n(9,2) #0453 Bruto_totaal_prijs Wordt altijd meegegeven n(9,2) #0454 Netto_totaal_prijs Wordt altijd meegegeven n(9,2) BTW bedrag hoog over het Bruto regelbedrag (verkoopfactuur) Netto BTW bedrag (verkoopfactuur) Netto prijs van één exemplaar inclusief BTW (verkoopfactuur) Bruto totaalbedrag inclusief BTW (verkoopfactuur) Netto totaalbedrag inclusief BTW (verkoopfactuur) 8

9 CB-id Attribuut naam Opmerking Format Standaard waarde Toelichting #0461 Afdracht_bedrag Wordt altijd meegegeven n(9,2) #0400 Opdracht_type Wordt altijd meegegeven an(6) Voorbeelden van mogelijk opdrachttypes: LNORM LEBOEK LGEENF LNAFN LNEIG LRAMSJ LPROM Netto totaalbedrag inclusief BTW (selfbilling factuur) #0455 Opdracht_type_nm Wordt altijd meegegeven an(40) LNORM LEBOEK LGEENF LNAFN LNEIG LRAMSJ LPROM Leveren normale koop Levering e-book Leveren zonder artikelfacturering Levering op naam afnemer Levering op naam eigenaar Levering Ramsj Promotionele levering #0456 Levereenheid_kd Optioneel n(10) Nummer van de levereenheid (pakbon) #0913 BTW_Afdracht_bedrag Wordt altijd meegegeven n(9,2) Netto BTW bedrag (selfbilling factuur) 9

10 CB-id Attribuut naam Opmerking Format Standaard waarde Toelichting #0477 Retourtype_kd Optioneel an(3) Mogelijke waarde: BES FVR MAN MIS NBE ONB OUD ROU RVR SEW VRR Verklaringen code: BES = retour ivm Beschadigd FVR = retour ivm vertrouwensretour MAN = manco melding MIS = retour ivm misdruk NBE = retour ivm niet bestelde opdracht ONB = retour ivm onberekend ontvangen OUD= retour ivm melding oude druk ROU = retour opdracht uitgever RVR= retour ivm recht van retour SEW= retour op S&W boek regeling VRR= retour ivm vrij recht van retour #0478 Bestemming_ind Optioneel an(1) Mogelijke waarde: C= toevoegen courante voorraad I= toevoegen Incourante voorraad Wordt uitsluitend meegegeven indien de uitgevoerde opdracht een retour/reclamatie betreft. Deze worden voorzien van indicatie van de reden welke bestemming de retour in de voorraadadministratie krijgt (courante voorraad, incourante voorraad. #0479 Correctie_ind Optioneel an(1) Mogelijke waarde: J = ja Leeg Indien de uitgevoerde opdracht een correctie op een eerdere uitgevoerde opdracht betreft zal deze waarde met J gevuld worden in alle andere gevalleen blijft ze waarde leeg #0914 BTW_Factor_Hoog Wordt altijd meegegeven n(8,6) Het deel van het BTW bedrag (#0913) dat BTW hoog betreft 10

11 CB-id Attribuut naam Opmerking Format Standaard waarde Toelichting #0917 Indiener_relatie_id Wordt altijd meegegeven n(7) Het 7 cijferig relatie id van de indiener van de opdracht #0928 BTW_bruto_bedrag_laag Wordt altijd meegegeven n(9,2) #0929 BTW_bruto_bedrag_hoog Wordt altijd meegegeven n(9,2) #0920 BTW_netto_bedrag_laag Wordt altijd meegegeven n(9,2) #0921 BTW_netto_bedrag_hoog Wordt altijd meegegeven n(9,2) #0918 BTW_afdr_bedrag_laag Wordt altijd meegegeven n(9,2) #0919 BTW_afdr_bedrag_hoog Wordt altijd meegegeven n(9,2) #0922 Bruto_totaal_prijs_laag Wordt altijd meegegeven n(9,2) #0923 Bruto_totaal_prijs_hoog Wordt altijd meegegeven n(9,2) #0924 Netto_totaal_prijs_laag Wordt altijd meegegeven n(9,2) #0925 Netto_totaal_prijs_hoog Wordt altijd meegegeven n(9,2) #0926 Afdracht_bedrag_laag Wordt altijd meegegeven n(9,2) #0927 Afdracht_bedrag_hoog Wordt altijd meegegeven n(9,2) #0462 Track_en_trace_info Optioneel an(50) BTW bedrag laag over het Bruto regelbedrag (verkoopfactuur) BTW bedrag hoog over het Bruto regelbedrag (verkoopfactuur) BTW bedrag laag over het Netto regelbedrag (verkoopfactuur) BTW bedrag hoog over het Netto regelbedrag (verkoopfactuur) BTW bedrag laag over het Netto regelbedrag (selfbillingfactuur) BTW bedrag hoog over het Netto regelbedrag (selfbillingfactuur) Bruto regelbedrag inclusief BTW van het deel wat belast is met laag BTW (verkoopfactuur) Bruto regelbedrag inclusief BTW van het deel wat belast is met hoog BTW (verkoopfactuur) Netto regelbedrag inclusief BTW van het deel wat belast is met laag BTW (verkoopfactuur) Netto regelbedrag inclusief BTW van het deel wat belast is met hoog BTW (verkoopfactuur) Netto regelbedrag inclusief BTW van het deel wat belast is met laag BTW (selfbilling factuur) Netto regelbedrag inclusief BTW van het deel wat belast is met hoog BTW (selfbilling factuur) Track en trace informatie waarbij de zending van de betreffende pakketvervoerder gevolgd kan worden #0463 Uitvoer_dat Wordt altijd meegegeven n(8) (yyyymmdd) Datum waarop de opdracht is geproduceerd/uitgevoerd #0422 CB_factuurregelreferentie Optioneel N(10) Wordt gevuld indien CB ook de facturering van de uitgevoerde opdracht verzorgd. Dus bijvoorbeeld niet bij opdrachttype VV, LGEENF, LNEIG, LCONS #0931 Bruto_prijs_ex_btw Wordt altijd meegegeven n(9,2) Bruto prijs exclusief BTW #0932 Netto_prijs_ex_btw Wordt altijd meegegeven n(9,2) Netto prijs exclusief BTW 11

12 #0933 Bruto_totaal_bedrag_ex_btw Wordt altijd meegegeven n(9,2) #0934 Netto_totaal_bedrag_ex_btw Wordt altijd meegegeven n(9,2) Bruto totaal bedragexclusief BTW (Aantal * Bruto prijs exclusief BTW) Netto totaal bedrag exclusief BTW (Aantal * Netto prijs exclusief BTW) Recordtype 9 Footer informatie De footer bevat informatie over het aantal in het bericht opgenomen recordtypen en dient als een controle op de volledigheid van het bericht. Standaard CB-id Attribuut naam Opmerking Format Toelichting waarde #0001 Record_type Wordt altijd meegegeven n(1) 9 Record type 9 #0015 Aant_detail_2 Wordt altijd meegegeven n(6) Aantal regels van recordtype 2 in dit bericht. #0016 Aant_detail_3 Wordt altijd meegegeven n(6) Aantal regels van recordtype 3 in dit bericht. #0017 Aant_detail_4 Wordt altijd meegegeven n(6) Aantal regels van recordtype 4 in dit bericht. #0006 Bericht_referentie Wordt altijd meegegeven n(10) De unieke referentie van het bericht. Waarde is gelijk aan de waarde in veld #0006 in de header informatie 3.2. Toelichting match UITOPD 1. Voor een UITOPD bericht is de match met de oorspronkelijk door de klant ingediende opdracht/order te maken via de referentie velden in het bericht: a. #0403 eigenaar_opdr_ref b. #0404 afnemer_opdr_ref c. #0440 eigenaar_regel_ref d. #0441 afnemer_regel_ref 2. Voor een match van UITOPD met facturering (selfbilling factuur ) kan #0422 CB_factuurregel referentie gebruikt worden deze wordt uitsluitend gevuld als CB ook de facturering heeft uitgevoerd. 12

13 3. De hieronder genoemde velden zijn in het UITOPD opgenomen op verzoek van een aantal aangesloten klanten voor de compatibiliteit van hun interne systemen. In de toelichting van deze velden staat dat er afrondingsverschillen ten opzichte van de selfbilling factuur mogelijk zijn. Wij raden u af deze velden (indien dat niet noodzakelijk is ) te verwerken. CB-id Attribuut naam Toelichting #0902 Retail_prijs #0907 Prijs_hoog_btw #0911 Btw_bdr #0453 Bruto_totaal_prijs #0454 Netto_totaal_prijs #0461 Afdracht_bedrag #0913 BTW_Afdracht_bedrag Netto prijs van één exemplaar inclusief BTW (verkoopfactuur) BTW bedrag hoog over het Bruto regelbedrag (verkoopfactuur) Netto BTW bedrag (verkoopfactuur) Bruto totaalbedrag inclusief BTW (verkoopfactuur) Netto totaalbedrag inclusief BTW (verkoopfactuur) Netto totaalbedrag inclusief BTW (selfbilling factuur) Netto BTW bedrag (selfbilling factuur) #0914 BTW_Factor_Hoog Het deel van het BTW bedrag (#0913) dat BTW hoog betreft #0928 BTW_bruto_bedrag_laag #0929 BTW_bruto_bedrag_hoog #0920 BTW_netto_bedrag_laag #0921 BTW_netto_bedrag_hoog BTW bedrag laag over het Bruto regelbedrag (verkoopfactuur) BTW bedrag hoog over het Bruto regelbedrag (verkoopfactuur) BTW bedrag laag over het Netto regelbedrag (verkoopfactuur) BTW bedrag hoog over het Netto regelbedrag (verkoopfactuur) 13

14 #0918 BTW_afdr_bedrag_laag BTW bedrag laag over het Netto regelbedrag (selfbillingfactuur) #0919 BTW_afdr_bedrag_hoog BTW bedrag hoog over het Netto regelbedrag (selfbillingfactuur) #0922 Bruto_totaal_prijs_laag Bruto regelbedrag inclusief BTW van het deel wat belast is met laag BTW (verkoopfactuur) #0923 Bruto_totaal_prijs_hoog Bruto regelbedrag inclusief BTW van het deel wat belast is met hoog BTW (verkoopfactuur) #0924 Netto_totaal_prijs_laag Netto regelbedrag inclusief BTW van het deel wat belast is met laag BTW (verkoopfactuur) #0925 Netto_totaal_prijs_hoog Netto regelbedrag inclusief BTW van het deel wat belast is met hoog BTW (verkoopfactuur) #0926 Afdracht_bedrag_laag Netto regelbedrag inclusief BTW van het deel wat belast is met laag BTW (selfbilling factuur) Netto regelbedrag inclusief BTW van het deel wat belast is met 3.3. Correcties in UITOPD #0927 Afdracht_bedrag_hoog hoog BTW (selfbilling factuur) Correcties op uitgevoerde opdrachten worden verwerkt als tegen boeking op de oorspronkelijke uitgevoerde opdracht (als negatief aantal geboekt) en nieuwe op boeking (tegen de gecorrigeerde condities, etc.) De opdrachttypen die voor correcties gebruikt worden zijn die van de oorspronkelijke opdracht (tegen boeking) en de gewenste (nieuwe op boeking). Correcties worden voorzien van een indicatie dat betreffende boekingsregels tot stand gekomen zijn naar aanleiding van een correctieopdracht Uitgevoerde opdracht versus voorraadstand/goederenbeweging In het UITOPD bericht (melding geleverde artikelexemplaren) zijn een aantal datum elementen opgenomen, namelijk: #0451 uitlever_dat o De dag waarop de aflevering bij de klant gepland is. #0463 uitvoer_dat o De productiedag waarop de opdracht (die bericht wordt via UITOPD) is uitgevoerd. # Faktuur_dat o Factuurdatum van de verkoopfactuur aan de afnemer waarop deze opdracht is gefactureerd. LET OP: Een mismatch is mogelijk voor de uitgevoerde opdrachten die op de huidige dag ontstaan tussen ± en uur (deze zitten morgen om uur in de UITOPD berichtgeving). Immers, deze uitgevoerde opdrachten worden op de huidige dag verantwoord (qua uitvoerdatum), maar zullen in de goederenbewegingen 14

15 zitten van de volgende periode en dus niet in de goederenbeweging die morgen om uur bericht worden. Daarnaast kan er omtrent het weekend een mismatch ontstaan. Als er op zondag gewerkt wordt kunnen er uitgevoerde opdrachten ontstaan met zondag als uitvoerdatum, terwijl het peilmoment van de voorraadstand om uur is. Opmerking: Het aan de eigenaar/uitgever verantwoorden van de voorraadstand van een artikel op een bepaald moment en de mutaties (goederenbewegingen) die hierin de afgelopen periode hebben plaatsgevonden, is een op zich staande activiteit. Het is nooit de bedoeling geweest dat de uitgevoerde opdrachten (geleverde exemplaren) direct te relateren zijn aan de over een bepaalde periode gemaakte goederenbewegingen. Natuurlijk is het wel zo dat over een langere periode bekeken het saldo van de geleverde exemplaren volgens de UITOPD overeen moet komen met het saldo van de goederenbewegingen die betrekking hebben op geleverde exemplaren. 15

16 CB Nederland Erasmusweg AK Culemborg +31 (0) cb-logistics.nl CB Vlaanderen +31 (0) cb-logistics.be