Statusrapport avvisade betalningar i Handelsbankens semikilon separerade CSVformat Version 0.1.1 Publiceringsdatum 2009-05-15
Innehållsförteckning 1 INLEDNING... 3 1.1 DEFINITIONER... 3 1.2 HISTORIK... 3 2 INFORMATION OM TJÄNSTEN... 4 2.1 BEGRÄNSNINGAR I TJÄNSTEN... 4 2.1.1 Lokala betalningar i GlobalOn-Line... 4 2.1.2 Överföringar mellan egna konton via GlobalOn-Line... 4 2.1.3 Utlandsbetalningar med debetkonto i annat land än Sverige/annan bank... 5 2.2 PARTER... 5 2.3 AVTAL... 5 3 SCENARIO: STATUSRAPPORT AVVISADE BETALNINGAR... 6 4 FORMATBESKRIVNING... 7 4.1 AFFÄRSREGLER... 7 4.2 FORMATETS UPPBYGGNAD... 7 4.3 INNEHÅLL... 7 4.3.1 Startpost... 7 4.3.2 Informationspost... 8 4.3.3 Slutpost... 8 4.4 EXEMPEL... 9 4.4.1 Startpost... 9 4.4.2 Informationspost... 9 4.4.3 Slutpost... 9 5 DATAFORMATREGLER... 10 5.1 FILEXEMPEL... 10 Statusrapport avvisade betalningar Sid 2 (10)
1 Inledning Handelsbanken tillhandahåller statusrapport avvisade betalningar i Handelsbankens semikolon separerade CSV-format. Statusrapporteringen består av en rapportfil skapad av banken med information om avvisade betalningar. Statusrapporten skapas efter det att fil med betalningsuppdrag mottagits av banken. I statusrapporten framgår avvisningsorsaken i klartext. Beskrivningen är specifik för Handelsbankens tjänster och rutiner och ska därför enbart användas i samarbete med Handelsbanken 1.1 Definitioner Term BBAN IBAN Beskrivning BBAN står för Basic Bank Account Number och identifierar ett unikt nationellt bankkontonummer. Ett BBAN kan bestå av upp till 30 tecken och kan vara alfanumeriskt. Utifrån ett BBAN konstrueras ett internationellt IBAN. IBAN står för International Bank Account Number och består av en landkod., kontrollsiffra, bankidentifierare och ett nationellt kontonummer. Ett svenskt IBAN består av totalt 24 tecken och ett utländskt IBAN kan bestå av upp till 34 tecken. 1.2 Historik Version Datum Beskrivning 0.1.1 publicerad 2008-05-23 Statusrapport avvisade betalningar Sid 3 (10)
2 Information om tjänsten Handelsbankens statusrapport avvisade betalningar i semikolon separerat CSV-format redovisar betalningsuppdrag insända via bankens filtjänster. Betalningar bokade i bankens Internettjänst eller via kontor redovisas inte i rapporten. Avvisade, ej debiterade, betalningsuppdrag redovisas i en statusrapport skapad av Handelsbanken. Rapporten görs tillgänglig för kunden via Inkorgen i Handelsbankens Internettjänst eller via den kommunikation som avtalats med banken. För att underlätta matchningen av företagets transaktioner rekommenderar Handelsbanken att en egen referens anges för varje betalningsuppdrag som sänds på fil till banken. Denna referens återges i en eventuell statusrapport. Statusrapporten kan levereras vid två tillfällen: Status rapport 1: När filen är slutgodkänd och har mottagits av banken I samband med inläsning av fil skapar Handelsbanken en statusrapport med avvisade betalningar. Status rapport 2: I samband med utförandedagen En andra statusrapport med avvisade betalningsuppdrag skapas på utförandedagen om t.ex. täckning saknas på anvisat debiteringskonto. Betalningstyper som inte kan återredovisas i samband med utförandedagen presenteras nedan under rubriken 2.1 begränsningar i tjänsten. Avvisningsorsaken meddelas i klartext på engelska. Endast en avvisningsorsak per betalning redovisas även om ett betalningsuppdrag kan avvisas av flera felorsaker. Normalt sett redovisas avvisade uppdrag från samma filleverans i en statusrapport, men i vissa fall kan avvisade uppdrag från samma filleverans redovisas uppdelade på flera statusrapporter. 2.1 Begränsningar i tjänsten I detta avsnitt redovisas de betalningstyper som inte statusrapporteras i samband med utförandedagen. För dessa betalningstyper kan statusrapport endast levereras i samband med inläsningen av filen (Statusrapport 1). Om en betalning avvisas i senare skede, t.ex. av annan bank, meddelas detta på annat sätt, t ex via telefon, e-mail, brev eller via lokalt kontoutdrag. Redovisning av avvisad betalning/retur av pengar sker då enligt de regler som finns i respektive land/bank för betalningstypen. Betalning som avvisas i annan bank redovisas aldrig i statusrapporten. 2.1.1 Lokala betalningar i GlobalOn-Line Statusrapportering sker inte i samband med utförandedagen för följande typer av lokala betalningsuppdrag i GlobalOn-Line. Betalning med debetkonto i annan bank än Handelsbanken Finansiell betalning i Danmark, Finland, Norge, Sverige och Tyskland Expressbetalning i Estland CHAPS-betalning i Storbritannien Fedwire-betalning i USA Lokal betalning i Hong Kong och Singapore Plusgirobetalning 2.1.2 Överföringar mellan egna konton via GlobalOn-Line Statusrapportering sker inte i samband med utförandedagen. Statusrapport avvisade betalningar Sid 4 (10)
2.1.3 Utlandsbetalningar med debetkonto i annat land än Sverige/annan bank Statusrapportering sker inte i samband med utförandedagen för utlandsbetalningar med debetkonto i annat land än Sverige eller debetkonto i annan bank än Handelsbanken. 2.2 Parter Följande lista innehåller aktörer som deltar i utbytet av meddelandet statusrapportering avvisade betalningar. Part Beskrivning Kund Kund eller dess tjänsteleverantör Bank Handelsbanken 2.3 Avtal Avtal om tjänsten tecknas i bankens avtal om Betalnings- och Informationstjänster för företag. För mer information kontakta lokalt bankkontor. Statusrapport avvisade betalningar Sid 5 (10)
3 Scenario: Statusrapport avvisade betalningar Detta avsnitt innehåller en illustration på hur utbytet av information om avvisade betalningar sker mellan kunden och Handelsbanken. 1) Kunden sänder en fil med betalningar till banken. 2) Filen behandlas av banken. 3) Banken skapar statusrapport 1 med betalningar avvisade vid filinläsningen och gör den tillgänglig för kunden. 4) Statusrapporten hämtas av kund i Inkorgen via Handelsbankens Internettjänst eller valt kommunikationssätt. 5) Betalningar utförs på begärd utförandedag 6) Banken skapar statusrapport 2 med betalningar avvisade på utförandedagen och gör den tillänglig för kunden. Betalningar som avvisas men inte kan återrapporteras i statusrapport 2 (se begränsningar punkt 2.1) redovisas enligt lokala regler för respektive betalningstyp. 7) Kunden hämtar statusrapporten med betalningar som avvisats på utförandedagen. CSV statusrapport avvisade betalningar Kund Bank 1. Kund sänder in fil till banken 2. Filen behandlas av banken 3. Statusrapport 1 skapas Semikolon separerad CSV Statusrapport avvisade betalningar 4. Statusrapport 1 hämtas av kunden 5. Betalningar utförs på begärd utförandedag 6. Statusrapport 2 skapas på utförandedagen Semikolon separerad CSV Statusrapport avvisade betalningar 7. Statusrapport 2 hämtas av kunden Statusrapport avvisade betalningar Sid 6 (10)
4 Formatbeskrivning Detta avsnitt innehåller en beskrivning av formatet Semikolon separerad CSV statusrapport avvisade betalningar. Statusrapporten innehåller tre poster där varje avvisat uppdrag redovisas i en informationspost. Den information som återges presenteras under rubriken 4.2 Innehåll. Följande gäller för formatet: 4.1 Affärsregler [1] Fälten i informationsposten kan endast återges om de har registreras i insänd fil [2] Om uppgifter saknas om t.ex. fakturanummer lämnas fältet tomt av Handelsbanken [3] En statusrapport kan skapas fram t o m utförandedatum, d v s ett år framåt i tiden [4] Betalningsdatum / Bevakningsdatum får vara maximalt 12 månader framåt i tiden. [5] Betalningsdatum/Bevakningsdatum får passeras med maximalt 20 dagar inklusive dagens datum 4.2 Formatets uppbyggnad Semikolon separerad CSV statusrapport avvisade betalningar består av tre poster. 1. Startpost, innehåller det datum då filen skapades. 2. Informationspost, innehåller avvisningsorsak samt uppgifter om avvisad betalning som t.ex. mottagarens namn, kontonummer och fakturanummer. 3. Slutpost, innehåller en summeringsuppgift om det totala antalet avvisade transaktioner. 1..1 Startpost Semikolon separerad CSV Statusrapport avvisade betalningar 1..n Informationspost 1..1 Slutpost 4.3 Innehåll Detta avsnitt innehåller detaljerad information om de fält som kan återredovisas i statusrapporten. Filen presenteras i nedanstående ordning. 4.3.1 Startpost Beskrivning innehåller datum då filen skapades. Fältnamn Beskrivning Kommentar Fildatum Datum då filen skapas Statusrapport avvisade betalningar Sid 7 (10)
4.3.2 Informationspost Beskrivning innehåller detaljerad information från insända betalningsuppdrag. Fältnamn Beskrivning Kommentar Kundnummer Kundens identitet i Handelsbanken, t.ex. organisationsnummer Avsändarens kontonummer/bankgironummer Kontonummer som ska debiterats för betalningsuppdraget Avsändarens referens på insänd fil Avsändarens referens per meddelande Avsändarens egen referens Kundens egna filreferens för hela filen Kundens unika referens för varje meddelande (eller meddelandekedjor) mellan avsändaren och banken Kundens egna unika referens för det enskilda uppdraget Återges om den finns med i filen till banken, annars skapas en referens av banken Återges från t.ex. från MT101 tag 20 Saknas egen referens per transaktion i insänd fil till banken visas i stället en av banken skapad time-stamp (Obs ej sökbar) Avvisningsorsak Orsak till avvisning i klartext Texten visas på engelska Fält inlagt för framtida Används för närvarande inte utveckling Valutaslag Betalningsuppdragets valutaslag Valutakod enligt ISO-standard Uppdragsbelopp Uppdragsbelopp för Kreditnota anges med minustecken (-) betalningsuppdraget Av kund begärt utförandedatum Datum då kunden har begärt att få betalningen utförd Sista bevakningsdatum kreditnotor namn Mottagarens Clearingnummer, BIC eller Nationellt bank-id kontonummer Mottagar-ID Strukturerad referens Ostrukturerad referens/meddelande 4.3.3 Slutpost Ett sista datum som kunden begärt att banken bevakar kreditnotan Namnet på betalningsmottagaren bankförbindelse kontonummer kan bestå av ett nationellt kontonummer (BBAN), bankgiro eller ett internationellt kontonummer (IBAN) Företagets unika identitet för varje betalningsmottagare Referens till betalningsmottagaren t.ex. ocr-nummer Referens/meddelande till betalningsmottagaren Infaller detta datum på en dag som inte är en bankdag utför banken betalningen på närmast påföljande bankdag Beskrivning innehåller en summeringspost som redovisar antalet avvisade betalningsuppdrag Fältnamn Beskrivning Kommentar Antal avvisade Summa av antalet avvisade betalningsuppdrag betalningsuppdrag i filen Statusrapport avvisade betalningar Sid 8 (10)
4.4 Exempel Nedan presenteras ett exempel på en fil i formatet uttryckt i verksamhetstermer. Exemplet innehåller ett avvisat betalningsuppdrag som motsvarar den avvisade betalningen i tekniskt exempel i avsnitt 5.2. 4.4.1 Startpost Fältnamn Värde Kommentar Fildatum 2008-04-08 Datum då filen skapas 4.4.2 Informationspost Fältnamn Värde Kommentar Kundnummer 556677-8899 Avsändarens kontonummer/bankgironummer 9876-5432 Avsändarens referens på insänd fil Avsändarens egen referens Avvisningsorsak Valutaslag 000000000068100250402250025 Kundens referens för hela filen 110003 Kundens unika referens för det enskilda betalningsuppdraget Incorrect currency for transfer EUR Uppdragsbelopp 113,00 Av kund begärt utförandedatum namn Mottagarens Clearingnummer, BIC eller Nationellt bank-id kontonummer Ostrukturerad referens/meddelande 2008-05-05 Company ABC 82149 123456789 Fakturanummer 123 4.4.3 Slutpost Fältnamn Värde Kommentar Antal avvisade 1 betalningsuppdrag Statusrapport avvisade betalningar Sid 9 (10)
5 Dataformatregler I detta avsnitt anges regler och riktlinjer för implementering av Semikolon separerad CSV statusrapport avvisade betalningar. Filen avser ej utförda betalningar från konto i Handelsbanken Sverige [1] Filen består av poster som innehåller fält [2] Posterna är separerade med radbrytning [3] Fälten är semikolon ( ; ) separerade. Sista fältet avslutas ej med semokolon ( ; ). [4] Fält utan värde visas genom att efterföljande fältseparator följer direkt efter föregående ( ;; ) [5] Decimaltecken för alla tal är alltid kommatecken (, ) [6] Beloppsfälten: decimaltecken är alltid kommatecken (, ) och 2 decimaler anges. [7] Belopp anges utan tecken om det är positivt och med (-) minustecken om det är negativt. [8] Datum anges ÅÅÅÅ-MM-DD 5.1 Filexempel Här presenteras ett exempel på en fil som består av en avvisad betalning. Observera att raderna brutits för att passa i dokumentet. 2008-04-08 5566778899;98765432;000000000068100 50402250025;;110003;Incorrect currency for transfer;;eur;113,00; 2008-05-10;;Company ABC; 82149;123456789;;;Fakturanummer 123 1 Statusrapport avvisade betalningar Sid 10 (10)