Vedlegg. Appendiks til BSK implementeringsguide for e2b-formatet v.3.3. Formidling av vedlegg mellom kunde / bank. Versjon:

Transkript

1 Appendiks til BSK implementeringsguide for e2b-formatet v.3.3 Vedlegg Formidling av vedlegg mellom kunde / bank 4. mai 2011 Bankenes Standardiseringskontor Postboks 2644 Solli 0203 OSLO Tlf E-post: post@bsk.no

2 Revisjonshistorikk Dato Versjon Beskrivelse Forfatter 4. mai Vedtatt 4. mai 2011 Morten Krøgenes Innholdsfortegnelse 1. INNLEDNING 3 2. BRUKSOMRÅDER FOR VEDLEGG VISNING AV FAKTURA (B2C) VISNING AV FAKTURA (B2B) VEDLEGG TIL FAKTURA (KUN B2B) 3 3. FORMIDLINGSALTERNATIVER FOR VEDLEGG INTERN (EMBEDDED) URL FIL 3 4. BRUK AV VEDLEGG 4 5. VALIDERING PÅ VEDLEGG 4 6. EKSEMPLER FOR SENDINGSALTERNATIVER EKSEMPEL DER VEDLEGG LIGGER EMBEDDED: EKSEMPEL DER VEDLEGG TILGJENGELIGJØRES VIA URL: EKSEMPEL DER VEDLEGG LIGGER SOM FILVEDLEGG: 12 Bankenes Standardiseringskontor Postboks 2644 Solli 0203 OSLO Tlf E-post: post@bsk.no

3 1. INNLEDNING Formålet med løsningen er at fakturautsteder kan sende vedlegg i tillegg til den elektroniske fakturaen til sine kunder. Avtale med bank må inngås før forsendelse/mottak av vedlegg kan benyttes. 2. BRUKSOMRÅDER FOR VEDLEGG Utstedere/mottakere må ha en konkret avtale med sin bankforbindelse om fakturaer skal utveksles som B2C eller B2B fakturaer (eller både/og). 2.1 Visning av faktura (B2C) Brukes for å styre visningen av fakturaen uten bruk av style sheet. Vedlegget er den faktiske fakturaen for B2C da fakturainnhold ikke vises på annen måte i dette tilfellet. En vedlagt visning av faktura er ment for visuell bruk og trenger ikke å vise hele fakturainnholdet. 2.2 Visning av faktura (B2B) Brukes for å styre visningen av fakturaen uten bruk av style sheet. En vedlagt visning av faktura er ment for visuell bruk og trenger ikke å vise hele fakturainnholdet. 2.3 Vedlegg til faktura (kun B2B) Vedleggene er tilleggsinformasjon til fakturaen slik som timelister eller samtaledetaljer for telefoni. 3. FORMIDLINGSALTERNATIVER FOR VEDLEGG Bankene støtter tre måter å formidle vedlegg på. 3.1 Intern (embedded) Vedleggene kan innkapsles i fakturafilene. 3.2 URL Vedleggene kan utveksles gjennom en URL som sendes som vedleggsreferanse i XML filen. Utsteder er ansvarlig for at linken kan åpnes av mottaker. Dette er anbefalt utvekslingsalternativ for store vedlegg. 3.3 Fil Vedleggene kan utveksles som filvedlegg på format avtalt med banken. Normalt anbefales det å benytte PDF filer, men andre filtyper kan også benyttes etter avtale med den enkelte bank. Filnavn: VedleggsløsningKundeIG 1v0 Publ Side: 3 av 14

4 4. BRUK AV VEDLEGG Embedded og filvedlegg legges under MessageHeader der vedlegget vil tilhøre den påfølgende forekomst av Invoice/InvoiceHeader. Det vises her til den generiske beskrivelsen av e2b InterchangeHeader/MessageHeader versjon 1.0. For bruk av embedded vedlegg må dette følge hver faktura. Det er ikke mulig å knytte ett enkelt vedlegg til mange fakturaer i løsningen som er spesifisert for formidling mellom bankene. AttachmentNumber: Løpenummer for vedlegg. Da XML er rekkefølge uavhengig, bør vedleggene nummereres slik at man kan diktere en bestemt rekkefølge. Verdien på løpenummer bør være et tall og unikt. CopyIndicator: Angir at vedlegget er en kopi av det strukturerte dokumentet. Benyttes for å sende en visuell kopi av forretningsdokumentet. AttachmentName: Referanse til vedlegget skal peke på AttachmentName under Attachments. Navnet må være unikt per fakturafil fra utsteder. Bankforbindelsen til utsteder vil ha ansvar for å sikre at filnavn er unike helt frem til mottakers bank og kan derfor endre filnavn for å ivareta dette. 5. VALIDERING PÅ VEDLEGG Det foretas kontroll i fakturamottakers bank at vedlegg referert i en faktura eksisterer. Dersom vedlegg mangler, vil fakturamottakers bank få kvittering på at fakturaen ikke er komplett og at vedlegget ikke er videreformidlet. Referanse til manglende vedlegg vil ikke bli formidlet av mottakers bank til fakturamottaker. Fakturamottaker må i disse tilfeller ta kontakt med fakturautsteder, dersom ikke denne allerede har kontaktet mottaker i denne forbindelse, og be om utfyllende opplysninger om fakturaen. Validering av filvedlegg vil begrense seg til kontroll av navn og extension på filen. Total filstørrelse maks 200 MB inkl. vedlegg Navn på vedlegg kan ikke overskride 100 tegn og kan kun inneholde ASCII tegn. (A-Z, a-z, 1-9, samt -, _. Nordiske spesialtegn, etc. skal ikke benyttes. Filnavn skal være unikt pr. utsteder pr. fil innsendt til bank. Viruskontroll av vedlegg vil bli foretatt før formidling mellom fakturautsteders bank og fakturamottakers bank. Fakturautstedere/-mottakere anmodes likevel om å gjennomføre viruskontroll av vedlegg. Filnavn: VedleggsløsningKundeIG 1v0 Publ Side: 4 av 14

5 6. EKSEMPLER FOR SENDINGSALTERNATIVER Under vises eksempler på de forskjellige sendingsalternativene for vedlegg i e2b versjon 3.3. Bankene støtter vedlegg som formidles som en ekstern lenke (URL), innkapslet (embedded) i meldingen eller som filvedlegg. I Attachement elementet under Invoice nivået i meldingen legger referanse til vedlegg i meldingshodet, slik at riktig vedlegg kan matches med riktig faktura. Vedlegg sendes i MessageHeader (ref. generisk beskrivelse av e2b InterchangeHeader / MessageHeader versjon 1.0.). Figuren under viser den generiske oppbygningen av utvekslingen der det fremgår at konvolutt (Envelope), utvekslingshode (InterchangeHeader) og meldingshode (MessageHeader) er valgfrie elementer. Invoice elementet er alltid med i utvekslingen. Den fysiske vedleggsfilen skal legges under meldingshode. Filnavn: VedleggsløsningKundeIG 1v0 Publ Side: 5 av 14

6 6.1 Eksempel der vedlegg ligger embedded: <?xml version = "1.0" encoding = "UTF-8"?> <Interchange xmlns = " xmlns:xsi = " xsi:schemalocation = " file:///c:/users/morten.bsk/bsk/er%20gruppa/er%20oppgaver/efaktura/efaktura%20b2b%20uvekslingsløsning%20i%20norge/meldingshånd bok/xml%20schema/e2b_invoice_interchange_v3p3.xsd"> <MessageHeader> <Version/> <DocumentType> <DocumentCode>380</DocumentCode> <DocumentDescriptiveName>FAKTURA</DocumentDescriptiveName> </DocumentType> <MessageReference> </MessageReference> <MessageOwner>e2b</MessageOwner> <MessageType>Invoice</MessageType> <MessageVersion>3.3</MessageVersion> <language>no</language> <MessageOriginator> <Address>NO </Address> <AddressQualifier>efakturaID</AddressQualifier> </MessageOriginator> <MessageRecipient> <Address>NO </Address> <AddressQualifier>efakturaID</AddressQualifier> </MessageRecipient> <Attachment type = "INCLUDED"> <AttachmentNumber>1</AttachmentNumber> <CopyIndicator>NO</CopyIndicator> <AttachmentType>image/TIFF</AttachmentType> <AttachmentName> _vedlegg1.tiff</AttachmentName> <CustomContent> <Base64Data xmlns="">![cdata[ -- TIFF, formattert som base ]]</Base64Data> </CustomContent> </Attachment> </MessageHeader> <Invoice MessageVersion = "3.3" MessageOwner = "e2b" MessageType = "Invoice" language = "NO"> <MessageNumber>1</MessageNumber> <MessageTimestamp> T10:33:13.103</MessageTimestamp> <InvoiceHeader> <InvoiceType codetext = "Invoice">380</InvoiceType> <InvoiceStatus codetext = "Original">9</InvoiceStatus> <InvoiceNumber>1</InvoiceNumber> <InvoiceDate> </InvoiceDate> <Supplier> <PartyId schemeid = "efakturaid" schemename = "efakturaid">ndeanokk-no </partyid> <LocationId>NDEANOKK-NO </LocationId> <Name>Storebrand Livsforsikring AS</Name> <PostalAddress> <Address1>Postboks 500</Address1> <PostalCode>1327</PostalCode> <PostalDistrict>Lysaker</PostalDistrict> <CountryCode>NO</CountryCode> </PostalAddress> <ContactPerson> <Name>Tore Storebrand</Name> <ContactInformation> <PhoneNumber> </PhoneNumber> < Address>tore.storebrand@storebrand.no</ Address> <WebAddress> </ContactInformation> </ContactPerson> <OrgNumber> </OrgNumber> <AccountInformation> <AccountNumber> </AccountNumber> <IbanNumber>NO </IbanNumber> <SwiftNumber>NDEANOKK</SwiftNumber> </AccountInformation> </Supplier> <Buyer> <PartyId schemeid = "efakturaid" schemename = "efakturaid">ndeanokk-no </partyid> <LocationId>NDEANOKK-NO </LocationId> <Name>Perlemor</Name> <PostalAddress> Filnavn: VedleggsløsningKundeIG 1v0 Publ Side: 6 av 14

7 <Address1>Adresse1</Address1> <Address2>Adresse2</Address2> <Address3>Adresse3</Address3> <PostalCode>0491</PostalCode> <PostalDistrict>Oslo</PostalDistrict> </PostalAddress> <ContactPerson> <Name>nk9</Name> </ContactPerson> <OrgNumber> </OrgNumber> <Code>YourReference</Code> <Text>nk9</Text> </Buyer> <Payment> <DueDate> </DueDate> <Currency>NOK</Currency> <KidNumber> </KidNumber> </Payment> <Attachments> _vedlegg1.tiff</Attachments> <Code>Kundenummer</Code> <Text> </Text> <Code>Kontraktsnummer</Code> <Text>01</Text> <Code>Produkt</Code> <Text>Innskuddspensjon</Text> <Code>Kontonummer</Code> <Text> </Text> <Code>Fakturaperiode</Code> <Text> </Text> </InvoiceHeader> <InvoiceDetails> <LineItemNum>1</LineItemNum> <SuppliersProductId>1005</SuppliersProductId> <Description>Månedlige administrasjonsomkostninger</description> <LineItemAmount> </LineItemAmount> <LineItemNum>2</LineItemNum> <SuppliersProductId>1001</SuppliersProductId> <Description>Sparing til alderspensjon</description> <LineItemAmount> </LineItemAmount> <LineItemNum>3</LineItemNum> <SuppliersProductId>1002</SuppliersProductId> <Description>Forvaltningsomkostninger</Description> Filnavn: VedleggsløsningKundeIG 1v0 Publ Side: 7 av 14

8 <LineItemAmount> </LineItemAmount> <LineItemNum>4</LineItemNum> <SuppliersProductId>2001</SuppliersProductId> <Description>Sparing til alderspensjon for tidligere perioder</description> <LineItemAmount> </LineItemAmount> <LineItemNum>5</LineItemNum> <SuppliersProductId>3001</SuppliersProductId> <Description>Trekk fra innskudd tilgode-kontoen</description> <PrePaidAmount> </PrePaidAmount> <LineItemAmount>0</LineItemAmount> </InvoiceDetails> <InvoiceSummary> <InvoiceTotals> <LineItemTotalsAmount> </LineItemTotalsAmount> <ChargesTotalsAmount>0</ChargesTotalsAmount> <PrePaidAmount> </PrePaidAmount> <GrossAmount> </GrossAmount> <VatTotalsAmount>0</VatTotalsAmount> <NetAmount> </NetAmount> </InvoiceTotals> <VatTotalsInfo> <VatBaseAmount>0</VatBaseAmount> <VatAmount>0</VatAmount> </VatTotalsInfo> </InvoiceSummary> </Invoice> </Interchange> Filnavn: VedleggsløsningKundeIG 1v0 Publ Side: 8 av 14

9 6.2 Eksempel der vedlegg tilgjengeligjøres via URL: <?xml version = "1.0" encoding = "UTF-8"?> <Interchange xmlns = " xmlns:xsi = " xsi:schemalocation = " file:///c:/users/morten.bsk/bsk/er%20gruppa/er%20oppgaver/efaktura/efaktura%20b2b%20uvekslingsløsning%20i%20norge/meldingshånd bok/xml%20schema/e2b_invoice_interchange_v3p3.xsd"> <MessageHeader> <Version/> <DocumentType> <DocumentCode>380</DocumentCode> <DocumentDescriptiveName>FAKTURA</DocumentDescriptiveName> </DocumentType> <MessageReference> </MessageReference> <MessageOwner>e2b</MessageOwner> <MessageType>Invoice</MessageType> <MessageVersion>3.3</MessageVersion> <language>no</language> <MessageOriginator> <Address>NO </Address> <AddressQualifier>efakturaID</AddressQualifier> </MessageOriginator> <MessageRecipient> <Address>NO </Address> <AddressQualifier>efakturaID</AddressQualifier> </MessageRecipient> <Attachment type = "EXTERNAL"> <AttachmentNumber>1</AttachmentNumber> <CopyIndicator>NO</CopyIndicator> <AttachmentType>image/TIFF</AttachmentType> <AttachmentLocation> </Attachment> </MessageHeader> <Invoice MessageVersion = "3.3" MessageOwner = "e2b" MessageType = "Invoice" language = "NO"> <MessageNumber>1</MessageNumber> <MessageTimestamp> T10:33:13.103</MessageTimestamp> <InvoiceHeader> <InvoiceType codetext = "Invoice">380</InvoiceType> <InvoiceStatus codetext = "Original">9</InvoiceStatus> <InvoiceNumber>1</InvoiceNumber> <InvoiceDate> </InvoiceDate> <Supplier> <PartyId schemeid = "efakturaid" schemename = "efakturaid">ndeanokk-no </partyid> <LocationId>NDEANOKK-NO </LocationId> <Name>Storebrand Livsforsikring AS</Name> <PostalAddress> <Address1>Postboks 500</Address1> <PostalCode>1327</PostalCode> <PostalDistrict>Lysaker</PostalDistrict> <CountryCode>NO</CountryCode> </PostalAddress> <ContactPerson> <Name>Tore Storebrand</Name> <ContactInformation> <PhoneNumber> </PhoneNumber> < Address>tore.storebrand@storebrand.no</ Address> <WebAddress> </ContactInformation> </ContactPerson> <OrgNumber> </OrgNumber> <AccountInformation> <AccountNumber> </AccountNumber> <IbanNumber>NO </IbanNumber> <SwiftNumber>NDEANOKK</SwiftNumber> </AccountInformation> </Supplier> <Buyer> <PartyId schemeid = "efakturaid" schemename = "efakturaid">ndeanokk-no </partyid> <LocationId>NDEANOKK-NO </LocationId> <Name>Perlemor</Name> <PostalAddress> <Address1>Adresse1</Address1> <Address2>Adresse2</Address2> <Address3>Adresse3</Address3> <PostalCode>0491</PostalCode> <PostalDistrict>Oslo</PostalDistrict> </PostalAddress> <ContactPerson> Filnavn: VedleggsløsningKundeIG 1v0 Publ Side: 9 av 14

10 <Name>nk9</Name> </ContactPerson> <OrgNumber> </OrgNumber> <Code>YourReference</Code> <Text>nk9</Text> </Buyer> <Payment> <DueDate> </DueDate> <Currency>NOK</Currency> <KidNumber> </KidNumber> </Payment> <Attachments> _vedlegg1.tiff</Attachments> <Code>Kundenummer</Code> <Text> </Text> <Code>Kontraktsnummer</Code> <Text>01</Text> <Code>Produkt</Code> <Text>Innskuddspensjon</Text> <Code>Kontonummer</Code> <Text> </Text> <Code>Fakturaperiode</Code> <Text> </Text> </InvoiceHeader> <InvoiceDetails> <LineItemNum>1</LineItemNum> <SuppliersProductId>1005</SuppliersProductId> <Description>Månedlige administrasjonsomkostninger</description> <LineItemAmount> </LineItemAmount> <LineItemNum>2</LineItemNum> <SuppliersProductId>1001</SuppliersProductId> <Description>Sparing til alderspensjon</description> <LineItemAmount> </LineItemAmount> <LineItemNum>3</LineItemNum> <SuppliersProductId>1002</SuppliersProductId> <Description>Forvaltningsomkostninger</Description> <LineItemAmount> </LineItemAmount> Filnavn: VedleggsløsningKundeIG 1v0 Publ Side: 10 av 14

11 <LineItemNum>4</LineItemNum> <SuppliersProductId>2001</SuppliersProductId> <Description>Sparing til alderspensjon for tidligere perioder</description> <LineItemAmount> </LineItemAmount> <LineItemNum>5</LineItemNum> <SuppliersProductId>3001</SuppliersProductId> <Description>Trekk fra innskudd tilgode-kontoen</description> <PrePaidAmount> </PrePaidAmount> <LineItemAmount>0</LineItemAmount> </InvoiceDetails> <InvoiceSummary> <InvoiceTotals> <LineItemTotalsAmount> </LineItemTotalsAmount> <ChargesTotalsAmount>0</ChargesTotalsAmount> <PrePaidAmount> </PrePaidAmount> <GrossAmount> </GrossAmount> <VatTotalsAmount>0</VatTotalsAmount> <NetAmount> </NetAmount> </InvoiceTotals> <VatTotalsInfo> <VatBaseAmount>0</VatBaseAmount> <VatAmount>0</VatAmount> </VatTotalsInfo> </InvoiceSummary> </Invoice> </Interchange> Filnavn: VedleggsløsningKundeIG 1v0 Publ Side: 11 av 14

12 6.3 Eksempel der vedlegg ligger som filvedlegg: <?xml version = "1.0" encoding = "UTF-8"?> <Interchange xmlns = " xmlns:xsi = " xsi:schemalocation = " file:///c:/users/morten.bsk/bsk/er%20gruppa/er%20oppgaver/efaktura/efaktura%20b2b%20uvekslingsløsning%20i%20norge/meldingshånd bok/xml%20schema/e2b_invoice_interchange_v3p3.xsd"> <MessageHeader> <Version/> <DocumentType> <DocumentCode>380</DocumentCode> <DocumentDescriptiveName>FAKTURA</DocumentDescriptiveName> </DocumentType> <MessageReference> </MessageReference> <MessageOwner>e2b</MessageOwner> <MessageType>Invoice</MessageType> <MessageVersion>3.3</MessageVersion> <language>no</language> <MessageOriginator> <Address>NO </Address> <AddressQualifier>efakturaID</AddressQualifier> </MessageOriginator> <MessageRecipient> <Address>NO </Address> <AddressQualifier>efakturaID</AddressQualifier> </MessageRecipient> <Attachment type = "FILE"> <AttachmentNumber>1</AttachmentNumber> <CopyIndicator>NO</CopyIndicator> <AttachmentType>application/pdf</AttachmentType> <AttachmentName>Vedlegg.pdf</AttachmentName> </Attachment> </MessageHeader> <Invoice MessageVersion = "3.3" MessageOwner = "e2b" MessageType = "Invoice" language = "NO"> <MessageNumber>1</MessageNumber> <MessageTimestamp> T10:33:13.103</MessageTimestamp> <InvoiceHeader> <InvoiceType codetext = "Invoice">380</InvoiceType> <InvoiceStatus codetext = "Original">9</InvoiceStatus> <InvoiceNumber>1</InvoiceNumber> <InvoiceDate> </InvoiceDate> <Supplier> <PartyId schemeid = "efakturaid" schemename = "efakturaid">ndeanokk-no </partyid> <LocationId>NDEANOKK-NO </LocationId> <Name>Storebrand Livsforsikring AS</Name> <PostalAddress> <Address1>Postboks 500</Address1> <PostalCode>1327</PostalCode> <PostalDistrict>Lysaker</PostalDistrict> <CountryCode>NO</CountryCode> </PostalAddress> <ContactPerson> <Name>Tore Storebrand</Name> <ContactInformation> <PhoneNumber> </PhoneNumber> < Address>tore.storebrand@storebrand.no</ Address> <WebAddress> </ContactInformation> </ContactPerson> <OrgNumber> </OrgNumber> <AccountInformation> <AccountNumber> </AccountNumber> <IbanNumber>NO </IbanNumber> <SwiftNumber>NDEANOKK</SwiftNumber> </AccountInformation> </Supplier> <Buyer> <PartyId schemeid = "efakturaid" schemename = "efakturaid">ndeanokk-no </partyid> <LocationId>NDEANOKK-NO </LocationId> <Name>Perlemor</Name> <PostalAddress> <Address1>Adresse1</Address1> <Address2>Adresse2</Address2> <Address3>Adresse3</Address3> <PostalCode>0491</PostalCode> <PostalDistrict>Oslo</PostalDistrict> </PostalAddress> <ContactPerson> Filnavn: VedleggsløsningKundeIG 1v0 Publ Side: 12 av 14

13 <Name>nk9</Name> </ContactPerson> <OrgNumber> </OrgNumber> <Code>YourReference</Code> <Text>nk9</Text> </Buyer> <Payment> <DueDate> </DueDate> <Currency>NOK</Currency> <KidNumber> </KidNumber> </Payment> <Attachments>Vedlegg.pdf</Attachments> <Code>Kundenummer</Code> <Text> </Text> <Code>Kontraktsnummer</Code> <Text>01</Text> <Code>Produkt</Code> <Text>Innskuddspensjon</Text> <Code>Kontonummer</Code> <Text> </Text> <Code>Fakturaperiode</Code> <Text> </Text> </InvoiceHeader> <InvoiceDetails> <LineItemNum>1</LineItemNum> <SuppliersProductId>1005</SuppliersProductId> <Description>Månedlige administrasjonsomkostninger</description> <LineItemAmount> </LineItemAmount> <LineItemNum>2</LineItemNum> <SuppliersProductId>1001</SuppliersProductId> <Description>Sparing til alderspensjon</description> <LineItemAmount> </LineItemAmount> <LineItemNum>3</LineItemNum> <SuppliersProductId>1002</SuppliersProductId> <Description>Forvaltningsomkostninger</Description> <LineItemAmount> </LineItemAmount> Filnavn: VedleggsløsningKundeIG 1v0 Publ Side: 13 av 14

14 <LineItemNum>4</LineItemNum> <SuppliersProductId>2001</SuppliersProductId> <Description>Sparing til alderspensjon for tidligere perioder</description> <LineItemAmount> </LineItemAmount> <LineItemNum>5</LineItemNum> <SuppliersProductId>3001</SuppliersProductId> <Description>Trekk fra innskudd tilgode-kontoen</description> <PrePaidAmount> </PrePaidAmount> <LineItemAmount>0</LineItemAmount> </InvoiceDetails> <InvoiceSummary> <InvoiceTotals> <LineItemTotalsAmount> </LineItemTotalsAmount> <ChargesTotalsAmount>0</ChargesTotalsAmount> <PrePaidAmount> </PrePaidAmount> <GrossAmount> </GrossAmount> <VatTotalsAmount>0</VatTotalsAmount> <NetAmount> </NetAmount> </InvoiceTotals> <VatTotalsInfo> <VatBaseAmount>0</VatBaseAmount> <VatAmount>0</VatAmount> </VatTotalsInfo> </InvoiceSummary> </Invoice> </Interchange> Filnavn: VedleggsløsningKundeIG 1v0 Publ Side: 14 av 14