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

gebruikershandleiding

Uitgever

UITOPD bericht Informatie over: Uitgevoerde opdrachten bericht

Datum: 13-03-2013 Versie: 1.2

Inhoudsopgave 1.

2.

3.

Uitgevoerde opdrachten Uitgever 1.1. Uitgevoerde opdrachten Uitgever– UITOPD bericht 1.2. Levering van de berichten FTP account algemene informatie 2.1. Bestandsnamen 2.2. Ophalen van bestanden Berichtopbouw en berichtdefinitie UITOPD 3.1. Berichtdefinitie van het UITOPD bericht voor uitgevers 3.2. Toelichting match UITOPD 3.3. Correcties in UITOPD 3.4. Uitgevoerde opdracht versus voorraadstand/goederenbeweging

3 3 3 3 3 4 4 4 12 14 14

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.

1.2. 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.

2.1. 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

UITOPD Procesbeschrijving en berichtdefinitie versie 1.2

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


an(6)

UITOPD

Soort bericht

#0003

Versie_nr


an(5)

Versie van het bericht

#0004

Verzend_dat


n(8)

#0005

Verzend_tijd


n(4)

0809A sysdate (yyyymmdd) sysdate (yyyymmddI)

#0006

Bericht_referentie


n(10)

#0007

Acknowledgement_ind


n(1)

0

Verzendbevestiging t.b.v. controle CB

#0008

Test_ind


n(1)

0

Geeft aan of het om een testbericht gaat, enkel de waarde 0 zal voorkomen

Datum van verzenden Tijdstip van verzenden De unieke referentie van het bericht. Waarde is gelijk aan de waarde in veld #0006 in de footer informatie.

4


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


n(1)

1

Record type 1

#0009

Partij_type


an(4)

AFZ

Geeft aan dat dit de Afzender is van het bericht.

#0010

Partij_id


n(7)

8894126

Het 7-cijferig relatie-id waaronder de afzender van het orderbericht bekend is bij CB.

#0011

Partij_id_type


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


n(1)

1

Record type 1

#0009

Partij_type


an(4)

ONTV

Geeft aan wie de ontvanger is van het bericht

#0010

Partij_id


n(7)

#0011

Partij_id_type


an(2)

CB

Geeft het type van de betrokken partij (veld #0010) weer, altijd CB.

Het 7-cijferig relatie id van de ontvanger van het bericht

Recordtype2: Transactiegegevens CB-id

Attribuut naam

Opmerking

Format

Standaard waarde

Toelichting

#0001

Record_type


n(1)

2

Record type 2

#0903

Valuta_kd


an(3)

EUR

Valutacode

#0450

Faktuur_dat

Optioneel

n(8)

(yyyymmdd)

Factuurdatum van de verkoopfactuur aan de afnemer waarop deze opdracht is gefactureerd.

#0451

Uitlever_dat

Optioneel

n(8)

(yyyymmdd)

Verwachte bezorg/uitleverdatum

#0452

Faktuur_nr

Optioneel

n(9)

Factuurnummer van de verkoopfactuur aan de afnemer waarop deze opdracht is gefactureerd.

5


Recordtype3: Bij transactiebetrokken partijen CB-id

Attribuut naam

Opmerking

Format

#0001

Record_type


n(1)

Standaard waarde 3

#0009

Partij_type


an(4)

AFN

#0010

Partij_id


n(7)

#0011

Partij_id_type


an(2)

#0012

Stroom_nr

Optioneel

n(2)

Toelichting Recordtype 3 Geeft aan wie de afnemer is van de uitgevoerde opdracht Het 7-cijferig relatie id van de ontvanger van het bericht

CB

Geeft het type van de betrokken partij (veld #0010) weer, altijd CB. 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


Recordtype 4 Transactieregel Uitgevoerde opdrachtregel informatie Geeft detailinformatie over de uitgevoerde opdrachten CB-id

Attribuut naam

Opmerking

Format

Standaard waarde

Toelichting

#0001

Record_type


n(1)

4

Recordtype:4

#0200

EAN_artikel_kd


an(13)

Het EAN van het artikel

#0260

Eigenaar_relatie_id


n(7)

Het 7 cijferig relatie-id van de eigenaar van het artikel

#0403

Eigenaar_opdr_ref.

Optioneel

an(10)

Referentie van de opdracht ten behoeve van de eigenaar. indien meegegeven in de opdracht.

#0404

Afnemer_opdr_ref.

Optioneel

an(10)

Referentie van de opdracht ten behoeve van de afnemer/boekverkoper indien meegegeven in de opdracht.

#0440

Eigenaar_regel_ref.

Optioneel

an(10)

Referentie van de opdrachtregel ten behoeve van de eigenaar van het artikel, indien meegegeven in de opdracht.

#0441

Afnemer_regel_ref.

Optioneel

an(10)

Referentie van de opdrachtregel ten behoeve van de afnemer/boekverkoper indien meegegeven in de opdracht.

#0430

Exemp_aant


n(6)

Het uitgeleverde aantal exemplaren

an(4)

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

#0431

Transactie_vwc

Optioneel

Mogelijke waarde: AANB DIO DUD DIG

7


CB-id

Attribuut naam

Opmerking

Format

Standaard waarde

Toelichting 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 .... Dit is de ontvangstdatum van de opdracht bij CB

#0433

Verkoop_omz_srt

Optioneel

an(4)

Mogelijke waarde: NORM AANB RAMS PRES Daarnaast kunnen uitgevers zelf een VOS meegeven in de opdracht

#0401

Opdr_dat


n(8)

(yyyymmdd)

#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


n(8,2)

Advies verkoopprijs incl BTW ( vaste boekprijs)

#0907

Prijs_hoog_btw

Optioneel

n(9,2)

BTW bedrag hoog over het Bruto regelbedrag (verkoopfactuur) *afrondingsverschil mogelijk

#0911

Btw_bdr


n(9,2)

Netto BTW bedrag (verkoopfactuur) *afrondingsverschil mogelijk

#0902

Retail_prijs


n(9,2)

#0453

Bruto_totaal_prijs


n(9,2)

#0454

Netto_totaal_prijs


n(9,2)

Netto prijs van één exemplaar inclusief BTW (verkoopfactuur) *afrondingsverschil mogelijk Bruto totaalbedrag inclusief BTW (verkoopfactuur) *afrondingsverschil mogelijk Netto totaalbedrag inclusief BTW (verkoopfactuur) *afrondingsverschil mogelijk

8


CB-id

Attribuut naam

Opmerking

Format

#0461

Afdracht_bedrag


n(9,2)

#0400

Opdracht_type


an(6)

#0455

Opdracht_type_nm


an(40)

#0456

Levereenheid_kd

Optioneel

n(10)

#0913

BTW_Afdracht_bedrag


n(9,2)

Standaard waarde

Toelichting Netto totaalbedrag inclusief BTW (selfbilling factuur) *afrondingsverschil mogelijk

Voorbeelden van mogelijk opdrachttypes: LNORM LEBOEK LGEENF LNAFN LNEIG LRAMSJ LPROM

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

Nummer van de levereenheid (pakbon) Netto BTW bedrag (selfbilling factuur) *afrondingsverschil mogelijk

9


CB-id

#0477

Attribuut naam

Retourtype_kd

Opmerking

Optioneel

Format

an(3)

Standaard waarde Mogelijke waarde: BES FVR MAN MIS NBE ONB OUD ROU RVR SEW VRR

#0478

Bestemming_ind

Optioneel

an(1)

Mogelijke waarde: C= toevoegen courante voorraad I= toevoegen Incourante voorraad

#0479

Correctie_ind

Optioneel

an(1)

Mogelijke waarde: J = ja Leeg

#0914

BTW_Factor_Hoog


n(8,6)

Toelichting 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

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.

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 Het deel van het BTW bedrag (#0913) dat BTW hoog betreft

10


CB-id

Attribuut naam

Opmerking

Format

Standaard waarde

#0917

Indiener_relatie_id


n(7)

Het 7 cijferig relatie id van de indiener van de opdracht

#0928

BTW_bruto_bedrag_laag


n(9,2)

BTW bedrag laag over het Bruto regelbedrag (verkoopfactuur) *afrondingsverschil mogelijk

#0929

BTW_bruto_bedrag_hoog


n(9,2)

BTW bedrag hoog over het Bruto regelbedrag (verkoopfactuur) *afrondingsverschil mogelijk

#0920

BTW_netto_bedrag_laag


n(9,2)

BTW bedrag laag over het Netto regelbedrag (verkoopfactuur) *afrondingsverschil mogelijk

#0921

BTW_netto_bedrag_hoog


n(9,2)

BTW bedrag hoog over het Netto regelbedrag (verkoopfactuur) *afrondingsverschil mogelijk

#0918

BTW_afdr_bedrag_laag


n(9,2)

BTW bedrag laag over het Netto regelbedrag (selfbillingfactuur) *afrondingsverschil mogelijk

#0919

BTW_afdr_bedrag_hoog


n(9,2)

BTW bedrag hoog over het Netto regelbedrag (selfbillingfactuur) *afrondingsverschil mogelijk

#0922

Bruto_totaal_prijs_laag


n(9,2)

Bruto regelbedrag inclusief BTW van het deel wat belast is met laag BTW (verkoopfactuur)*afrondingsverschil mogelijk

#0923

Bruto_totaal_prijs_hoog


n(9,2)

Bruto regelbedrag inclusief BTW van het deel wat belast is met hoog BTW (verkoopfactuur)*afrondingsverschil mogelijk

#0924

Netto_totaal_prijs_laag


n(9,2)

Netto regelbedrag inclusief BTW van het deel wat belast is met laag BTW (verkoopfactuur) *afrondingsverschil mogelijk

#0925

Netto_totaal_prijs_hoog


n(9,2)

Netto regelbedrag inclusief BTW van het deel wat belast is met hoog BTW (verkoopfactuur) *afrondingsverschil mogelijk

#0926

Afdracht_bedrag_laag


n(9,2)

Netto regelbedrag inclusief BTW van het deel wat belast is met laag BTW (selfbilling factuur) *afrondingsverschil mogelijk

#0927

Afdracht_bedrag_hoog


n(9,2)

Netto regelbedrag inclusief BTW van het deel wat belast is met hoog BTW (selfbilling factuur) *afrondingsverschil mogelijk

#0462

Track_en_trace_info

Optioneel

an(50)

Track en trace informatie waarbij de zending van de betreffende pakketvervoerder gevolgd kan worden

#0463

Uitvoer_dat


n(8)

#0422

CB_factuurregelreferentie

Optioneel

N(10)

#0931

Bruto_prijs_ex_btw


n(9,2)

Datum waarop de opdracht is geproduceerd/uitgevoerd Wordt gevuld indien CB ook de facturering van de uitgevoerde opdracht verzorgd. Dus bijvoorbeeld niet bij opdrachttype VV, LGEENF, LNEIG, LCONS Bruto prijs exclusief BTW

#0932

Netto_prijs_ex_btw


n(9,2)

Netto prijs exclusief BTW

(yyyymmdd)

Toelichting

11


#0933

Bruto_totaal_bedrag_ex_btw


n(9,2)

#0934

Netto_totaal_bedrag_ex_btw


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


n(6)

Aantal regels van recordtype 2 in dit bericht.

#0016 Aant_detail_3


n(6)


#0017 Aant_detail_4


n(6)


#0006 Bericht_referentie


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


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

#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

#0914

BTW_Factor_Hoog

#0928

BTW_bruto_bedrag_laag

#0929

BTW_bruto_bedrag_hoog

#0920

BTW_netto_bedrag_laag

#0921

BTW_netto_bedrag_hoog

Toelichting Netto prijs van één exemplaar inclusief BTW (verkoopfactuur) *afrondingsverschil mogelijk BTW bedrag hoog over het Bruto regelbedrag (verkoopfactuur) *afrondingsverschil mogelijk Netto BTW bedrag (verkoopfactuur) *afrondingsverschil mogelijk Bruto totaalbedrag inclusief BTW (verkoopfactuur) *afrondingsverschil mogelijk Netto totaalbedrag inclusief BTW (verkoopfactuur) *afrondingsverschil mogelijk Netto totaalbedrag inclusief BTW (selfbilling factuur) *afrondingsverschil mogelijk Netto BTW bedrag (selfbilling factuur) *afrondingsverschil mogelijk Het deel van het BTW bedrag (#0913) dat BTW hoog betreft BTW bedrag laag over het Bruto regelbedrag (verkoopfactuur) *afrondingsverschil mogelijk BTW bedrag hoog over het Bruto regelbedrag (verkoopfactuur) *afrondingsverschil mogelijk BTW bedrag laag over het Netto regelbedrag (verkoopfactuur) *afrondingsverschil mogelijk BTW bedrag hoog over het Netto regelbedrag (verkoopfactuur) *afrondingsverschil mogelijk

13


3.3. Correcties in UITOPD

#0918

BTW_afdr_bedrag_laag

#0919

BTW_afdr_bedrag_hoog

#0922

Bruto_totaal_prijs_laag

#0923

Bruto_totaal_prijs_hoog

#0924

Netto_totaal_prijs_laag

#0925

Netto_totaal_prijs_hoog

#0926

Afdracht_bedrag_laag

#0927

Afdracht_bedrag_hoog

BTW bedrag laag over het Netto regelbedrag (selfbillingfactuur) *afrondingsverschil mogelijk BTW bedrag hoog over het Netto regelbedrag (selfbillingfactuur) *afrondingsverschil mogelijk Bruto regelbedrag inclusief BTW van het deel wat belast is met laag BTW (verkoopfactuur) *afrondingsverschil mogelijk Bruto regelbedrag inclusief BTW van het deel wat belast is met hoog BTW (verkoopfactuur) *afrondingsverschil mogelijk Netto regelbedrag inclusief BTW van het deel wat belast is met laag BTW (verkoopfactuur) *afrondingsverschil mogelijk Netto regelbedrag inclusief BTW van het deel wat belast is met hoog BTW (verkoopfactuur) *afrondingsverschil mogelijk Netto regelbedrag inclusief BTW van het deel wat belast is met laag BTW (selfbilling factuur) *afrondingsverschil mogelijk Netto regelbedrag inclusief BTW van het deel wat belast is met hoog BTW (selfbilling factuur) *afrondingsverschil mogelijk

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.

3.4. 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. #0450 - 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 ± 00.00 en 02.00 uur (deze zitten morgen om 08.00 uur in de UITOPD berichtgeving). Immers, deze uitgevoerde opdrachten worden op de huidige dag verantwoord (qua uitvoerdatum), maar zullen in de goederenbewegingen

14


zitten van de volgende periode en dus niet in de goederenbeweging die morgen om 06.30 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 14.00 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


CB Nederland Erasmusweg 10 4104 AK Culemborg +31 (0)345 47 59 11 [email protected]

cb-logistics.nl

CB Vlaanderen +31 (0)524 569 40 [email protected]

cb-logistics.be

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

Recommend Documents