Filformat och datatyper
Amilis filimportpipeline tar emot strukturerade datafiler som levereras via SFTP. Vilket system som helst, som kan exportera strukturerad data, kan integreras, men välkända eller standardiserade exportformat innebär i regel en snabbare uppsättning med mindre konfigurationsarbete på båda sidor.
Den här guiden förklarar vilka filformat Amili stöder, vilka typer av data som kan importeras och hur data i en fil mappas och importeras till Amili-plattformen.
Innehållsförteckning
- Filformat som stöds — Flatfil, XML och JSON
- Importoperationer — Vilka typer av data som kan skickas
- Hur data mappas — Från filfält till Amilis datamodell
- Färdiga mallar — System med färdiga konfigurationer
Filformat som stöds
Amili kan bearbeta filer i tre strukturerade format. Vilket format som passar bäst beror på vad ditt källsystem kan exportera.
| Format | Beskrivning | Typisk användning |
|---|---|---|
| Flatfil | Ren textfil där varje fält upptar en fast teckenposition på varje rad | Bokförings- och ERP-system som exporterar positionsbaserade flatfiler |
| XML | Strukturerat märkspråk med nästlade element | Journalsystem inom vård, fakturaexporter, Peppol e-fakturering |
| JSON | Strukturerat textformat med nyckel-värdepar och arrayer | Moderna system och API:er med JSON-exportmöjligheter |
Flatfil
Positionsbaserade flatfiler kodar data som textrader där varje fält börjar och slutar på en bestämd teckenposition. Olika radtyper identifieras med ett prefix i början av varje rad.
En fil innehåller vanligtvis flera posttyper — till exempel en radtyp för kunden och en annan för varje faktura eller skuld. Amilis importkonfiguration definierar de exakta positionerna och datatyperna för varje fält.
XML
XML-filer bär data som strukturerade, nästlade element. Amili använder XSLT-transformationer för att läsa källans XML-struktur och mappa den till Amilis datamodell. Det gör XML-integration flexibelt — Amili kan anpassa sig till ett brett spektrum av XML-scheman utan att kräva ändringar i ditt exportformat.
JSON
JSON-filer bär data som objekt och arrayer. Amili använder jq-transformationer för att extrahera och mappa fält från JSON-strukturen. JSON lämpar sig väl för system som redan producerar maskinläsbar utdata, eller där källdata levereras som en strukturerad API-export.
Importoperationer
Amili stöder fem typer av filbaserade importoperationer. En integration kan använda en eller flera av dessa, beroende på vad ditt system exporterar.
| Operation | Beskrivning |
|---|---|
| Fakturaregistrering | Skicka in en ny faktura för behandling. Amili skapar en faktura och ett tillhörande ärende i plattformen. |
| Ärenderegistrering | Skicka in en skuld eller fordran direkt som ett ärende, utan att först skapa en faktura. Används när fakturans livscykel hanteras externt. |
| Borgenärsbetalning | Meddela Amili att en betalning har mottagits direkt av borgenären, utanför Amilis betalningsflöde. |
| Borgenärsmakulering | Makulera ett tidigare registrerat ärende eller faktura. |
| Borgenärskreditering | Kreditera ett tidigare registrerat ärende och minska det utestående beloppet. |
Alla operationer behöver inte konfigureras från start. En vanlig startpunkt är fakturaregistrering, med betalning, makulering och kreditering som läggs till efter behov.
Hur data mappas
När Amili bearbetar en fil transformeras och mappas varje post till motsvarande import i plattformen. Transformationslogiken läser fälten från din fil och producerar den datastruktur som Amilis API förväntar sig.
Diagrammet nedan visar det övergripande flödet:
Kundinformation
För faktura- och ärenderegistreringar extraherar Amili information om slutkunden från filen. Följande fält mappas:
| Fält | Beskrivning |
|---|---|
| Namn | Kundens fullständiga namn |
| Personnummer/org.nr | Svenskt personnummer eller organisationsnummer |
| Adress | Gatuadress, postnummer, ort, land |
| Mobilnummer | Kundens telefonnummer för kommunikation |
| E-post | Kundens e-postadress för kommunikation |
| Kundnummer | Din interna referens för kunden (valfritt) |
Fält som är valfria i källfilen lämnas tomma i Amili om de inte anges.
Faktura- och skuldinformation
För faktura- och ärenderegistreringar mappas den finansiella datan enligt följande:
| Fält | Beskrivning |
|---|---|
| Fakturanummer | Din fakturareferens, används för att identifiera posten |
| Fakturadatum | Datum då fakturan utfärdades |
| Förfallodatum | Sista betalningsdag |
| Belopp | Ursprungligt fakturabelopp (kapital) |
| Valuta | ISO-valutakod, t.ex. SEK |
| Beskrivning | Fritext som beskriver skulden eller tjänsten |
För fakturaregistreringar kan även rader (artiklar) inkluderas — till exempel enskilda tjänster eller varor med styckpris och momssats.
Betalningsinformation
För borgenärsbetalningsfiler extraherar Amili:
| Fält | Beskrivning |
|---|---|
| Fakturareferens | Referens som kopplar betalningen till ett befintligt ärende eller faktura |
| Betalningsdatum | Datum då betalningen mottogs |
| Belopp | Betalt belopp |
| Valuta | ISO-valutakod |
Färdiga mallar
Amili har färdiga importmallar för ett antal vanligt förekommande system. Om ditt system finns bland dem går den initiala uppsättningen vanligtvis snabbare eftersom fältmappningen redan är definierad.
Exempel på system med färdiga mallar
Följande system har befintliga mallar och konfigurationer:
- Visma Business — Ärenderegistrering och betalningsfiler (flatfil)
- Visma RoR / RoR v2.1 — Ärenderegistrering (flatfil), Peppol-faktura (XML)
- Agresso CU12 — Ärenderegistrering (flatfil)
- Cosmic — Fakturaregistrering och makulering (XML)
- SARA — Fakturaregistrering och makulering (JSON)
- Webdoc — Fakturaregistrering och kreditering (XML)
Dessa är exempel på system med färdiga mallar — integrationer är inte begränsade till dessa.
Om ditt system inte finns med kan Amili bygga en anpassad mall — kravet är att ditt system kan exportera data i något av de tre filformaten (flatfil, XML eller JSON) med de fält som beskrivs ovan.
Vad du behöver ta fram för en anpassad integration
Om du integrerar ett system som inte har en färdig mall, ta med följande till den inledande diskussionen med Amili:
- En exempelfil från ditt system som representerar verklig produktionsdata
- En fältbeskrivning som förklarar vad varje fält eller kolumn i exporten innehåller
- En tydlig bild av vilka operationer du vill använda (fakturaregistrering, betalningar osv.)
Amili använder detta underlag för att bygga en mall och validera den mot din exempelfil innan driftsättning.
Nästa steg
- SFTP-fildropoff och filhämtning — Hur du levererar filer till Amili och hämtar rapportfiler
- Filintegrationsprocess — Den fullständiga onboardingprocessen för filintegration