ICAXML v1.0 Import av ärenden för inkassohantering 2008-12-10
2 (7) Inledning Fillayout ICAXML används för import av ärenden för inkassotjänster i Aptic Collect. Importfilen är en XML-fil som måste följa ett specifikt schema. XML-schemat kan hämtas från http://schema.aptic.net/aptic-link-import-accounts.xsd. I schemat kan samtliga fält som finns tillgängliga utläsas, ordningen på dessa samt vilka som är obligatoriska. Många fält är frivilliga och kommer att ersättas av standardvärden om de inte fylls i. Exempel Exempelfilen nedan innehåller ett ärende med två fakturor. Om filen innehåller flera ärenden upprepas elementet <account> för respektive ärende. <?xml version="1.0" encoding="iso-8859-1"?> <accounts xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:nonamespaceschemalocation="http://schema.aptic.net/aptic-link-importaccounts.xsd"> <journal currencycode="sek"> <account creditor="1000"> <debtor idnumber="19500101-5050" firstname="gunnar" lastname="gäldenär" street="storgatan 12" city="skövde" zipcode="54132" workphone="0500-100200" > <address addresstype="avi" street="torpet, pl 1298" city="stenstorp" zipcode="52050" /> </debtor> <debt description="juridisk konsultation, 2007-10-10, 3 timma" referencenumber="123461-07" remainingprincipal="4500.00" remaininginterest="0.00" remainingvat="0.00" billdate="2007-11-01" duedate="2007-12-01" ourreference="anna Advokat" /> <fee name="remind" description="påminnelseavgift" feedate="2007-12-15" remainingprincipal="50.00" remaininginterest="0.00" remainingvat="0.00" /> <extrafield name="diarienummer">212-320/18</extrafield> <note>har skickat två påminnelser, samt ringt, utan resultat.</note> </account> </journal> </accounts>
3 (7) Fältförklaringar Nedan följer en kortare beskrivning av de fält (element) som kan användas. Element Typ Beskrivning accounts counterkey string (15) Filräknaridentitet. Namnet på filräknare. Används för att kontrollera att filer läses in i rätt ordning. countervalue integer Filnummer. Används för att kontrollera att filer läses in i rätt ordning. accounts/journal currencycode string (3) Valutakod enligt ISO 4217. Obligatorisk accounts/journal/account creditor string (50) Klientreferensnummer. currencycode string (3) Valutakod enligt ISO 4217. referencenumber string (50) Ärendets referensnummer (OBS! inte fakturanummer) deliverysystemcode string (15) Avsändande system paymentreference string (25) OCR-nummer service string (25) Inkasso collector string (50) Föredragen handläggare för ärendet. accounts/journal/account/debtor idnumber string (15) Gäldenärens person/organisationsnummer debtorrole string Gäldenärsroll juridicaltype integer 1 = privatperson, 2 = juridisk person placeofbirth string (50) Födelseställe salutation string (10) Gäldenärens titel firstname string (100) Gäldenärens förnamn middlename string (40) Gäldenärens mellannamn lastname string (60) Gäldenärens efternamn namesuffix string (10) Gäldenärens ordningsnummer, el. dyl. careof string (50) Gäldenärens c/o adress street string (200) Gäldenärens adress (kan innehålla radbrytning) city string (30) Gäldenärens postort statecode string (2) Gäldenärens stat eller region zipcode string (10) Gäldenärens postnummer countrycode string (2) Gäldenärens landskod enl. ISO 3166-1 alpha-2 country string (30) Gäldenärens land (översätts till landskod)
4 (7) domicile string (10) Gäldenärens sate homephone string (20) Telefonnummer hem workphone string (20) Telefonnummer arbete cellularphone string (20) Mobiltelefon telefax string (20) Telefaxnummer email string (80) Gäldenärens e-post-adress languagecode string (2) Språkkod, sv = svenska, en = engelska, osv. currencycode string (3) Valuta som gäldenären föredrar underaged boolean Underårig gäldenär. Om fältet utelämnas beräknas gäldenärens ålder utifrån personnummer och fakturadatum. accounts/journal/account/debtor/address addresstype string Typ av address: legal = folkbokföringsadress avi = Aviseringsadress invoice = Faktureringsadress eller enligt överenskommelse addressnotvalid date Datum då denna address markerats som felaktig fullname string (80) Avvikande namn för gäldenären careof string (50) C/o adress street string (200) Adress (kan innehålla radbrytning) city string (30) Postort statecode string (2) Stat eller region zipcode string (10) Postnummer countrycode string (2) Landskod enl. ISO 3166-1 alpha-2 country string (30) Land (översätts till landskod) defaultaddress boolean Detta är gäldenärens standardadress accounts/journal/account/debtor/extrafield name string (20) Namn på gäldenärens extrafält. Används enligt överenskommelse. text() string (200) Extrafältets värde accounts/journal/account/debt description string (80) Allmänn beskrivning av fakturan/skulden referencenumber string (25) Fakturanummer debtgroup string (15) Skuldgruppskod för gruppering av fakturan ledgerref string (25) Reskontrareferensnummer originalprincipal Money Ursprungligt kapitalbelopp remainingprincipal Money Resterande kapital vid exportfillfället (obligatorisk) originalinterest Money Ursprungligt uppräknad ränta
5 (7) remaininginterest Money Beräknad ränta till och med interestto currencycode string (3) Skuldens valuta enligt ISO 4217 billdate date Fakturadatum (obligatorisk) duedate date Förfallodatum paymentcondition integer Betalningsvillkor interestrate decimal Räntesats interestcode string (10) Räntekod, t.ex. ÖGR = over gällande referensränta interestfrom date Ränta beräknad från interestto date Ränta beräknad till och med ourreference string (50) Vår referens yourreference string (50) Er referens periodoflimitation integer Preskiberingstid i år limitationdate date Datum för preskibering accounts/journal/account/debt/extrafield name string (20) Namn på skuldens extrafält. Används enligt överenskommelse. text() string (200) Extrafältets värde accounts/journal/account/fee name string (50) Kostnadskod. Definierad i tabll cfg_fee, tex REMIND = påminnelsekostnad description string (25) Beskrivning av kostnaden, t.ex Påminnelseavgift. Om inte angiven används cfg_fee_desc feedate date Datum då kostnaden uppstod reaminingprincipal money Kostnadens nettobelopp remainingvat money Kostnadens momsbelopp remaininginterest money Räntebelopp currencycode string (3) Valutakod enligt ISO 4217 interestrate decimal Räntesats interestcode string (10) Räntekod, t.ex. ÖGR = over gällande referensränta interestfrom date Ränta beräknad från interestto date Ränta beräknad till och med accounts/journal/account/rentalobject objectnumber string (30) Objekt/lgh nummer (obligatorisk) rentalobjecttypeid string (10) 1 = Hyresrätt, 2 = Bostadsrätt, 3 = Garage, 4 = P-plats, 5 = Lokal, 6 = Arrende, 7 = Samfällighetsförening objectdescription string (200) Objektbeskrivning
6 (7) propertydescription string (80) Fastighetsbeskrivning street string(200) Fastighetens gatuadress city string (30) Fastighetens ort zipcode string (10) Fastighetens postnummer countrycode string (2) Fastighetens landskod accounts/journal/account/energydebt disconnect boolean Frånkoppling ska ske (obligatorisk) hasmoved boolean Avflyttad (obligatorisk) installationid string (200) Anläggnings-id (obligatorisk) netownerparty string (80) Nätägare (referensnummer) servedat string(200) Delgiven datum disconnected boolean Frånkopplad accounts/journal/account/extrafield name string (20) Namn på ärendets extrafält. Används enligt överenskommelse. text() string (200) Extrafältets värde accounts/journal/account/note text() string (200) Notering som visas på ärendets historic. loggedat datetime Tidsstämpel för noteringen (används vid migrering) systemcode string (20) Systemkod (används vid migrering) usercode string (20) Användarkod (används vid migrering) important boolean true = viktig notering histownertypeid integer Ägartyp (används vid migrering) histnotetypeid integer Noteringstyp (används vid migrering) accounts/journal/account/claimant referencecode string (15) Fordringsägarens referensnummer, t.ex. klientens klientnummer (obligatorisk) idnumber string (15) Fordringsägarens organisationsnummer (obligatorisk) fullname string (100) Fordringsägarens namn (obligatorisk) street string (200) Fordringsägarens gatuadress city string (30) Fordringsägarens postort zipcode string (10) Fordringsägarens postnummer statecode string (2) Fordringsägarens stat eller region countrycode string (20) Fordringsägarens landskod country string (50) Fordringsägarens land i klartext languagecode string (2) Språkkod
7 (7) workphone string (20) Fordringsägarens telefonnummer. internalphone string (10) Fordringsägarens interntelefonnummer. telefax string (20) Fordringsägarens telefaxnummer. email string (80) Fordringsägarens e-post-adress currencycode string (3) Fordringsägarens presentationsvaluta.