Fennoa: Myyntilaskuaineistosiirto

Tämä ohje koskee Maxtech Pro™ -palvelua. Maxtech Easy™ käyttäjille on olemassa erilliset ohjeet.

Tämä toiminnallisuus kuuluu seuraaviin tuotteisiin ja vaatii toimiakseen seuraavat moduulit:

TUOTTEET	moduulit
Laskutusrivit, -aineistot ja kateraportti™	Fennoa-myyntilaskut

Tiedoston nimi	N/A (palvelujen välinen tiedonsiirto)
Järjestelmien välinen tiedonsiirtotapa	Palvelujen välinen tiedonsiirto
Tiedostoformaatti	xml (Finvoice 2.0)
Merkistö	UTF-8
Päivämääräformaatti	YYYY-MM-DD (esimerkiksi: 2022-06-22)
Desimaalierotin	piste (.)
Tuhaterotin	Ei käytössä

Rajapinnassa siirrettävät tiedot

Myyjän tiedot tulevat laskulle Fennoasta.

Maxtech-JÄRJESTELMÄN kenttä	XML-ELEMENTTI
Sähköisen laskutuksen ovt-tunnus (asiakkaan tiedoista)	MessageTransmissionDetails -> MessageReceiverDetails -> ToIdentifier
Sähköisen laskutuksen välittäjätunnus (asiakkaan tiedoista)	MessageTransmissionDetails -> MessageReceiverDetails -> ToIntermediator
Nimi (asiakkaan tiedoista)	BuyerOrganisationName
Y-tunnus (yksityisasiakkaalla asiakasnumero)	BuyerPartyIdentifier (jos Y-tunnus on validi, laskulle muodostuu myös BuyerOrganisationTaxCode eli ALV-tunnus)
Osoite (katu)	BuyerStreetName
Osoite (kaupunki)	BuyerTownName
Osoite (postinumero)	BuyerPostCodeIdentifier

Laskuille luodaan laskunumero Fennoassa ja laskut tallentuvat Fennoaan luonnoksina.

Maxtech-JÄRJESTELMÄN kenttä	XML-ELEMENTTI
Kiinteästi ’INV01’ (Tavallinen lasku)	InvoiceTypeCode
Kiinteästi ’Lasku’	InvoiceTypeText
Kiinteästi ’Original’	OriginCode
Kuluva päivä	InvoiceDate
Viitteemme (Laskulla) (asiakkaan tiedoista)	SellerReferenceIdentifier
Viitteenne (Laskulla) (asiakkaan tiedoista)	BuyerReferenceIdentifier
Laskurivien yhteenlaskettu veroton summa	InvoiceTotalVatExcludedAmount
Laskurivien yhteenlaskettu veron summa	InvoiceTotalVatAmount
Laskurivien yhteenlaskettu verollinen summa	InvoiceTotalVatIncludedAmount
Verokantaerittely	VatSpecificationDetails
Laskutuksen lisätiedot (asiakkaan tiedoista)	InvoiceFreeText
Maksuehto, ensisijaisesti asiakkaan laskutustiedoista ja toissijaisesti organisaation asetuksista	PaymentTermsDays
Eräpäivä, lasketaan ensisijaisesti asiakkaan laskutustiedoissa ja toissijaisesti organisaation asetuksissa olevan maksuehdon perusteella (kuluva päivä + maksuehto)	InvoiceDueDate
Kiinteästi ’Viivästyskorko’	PaymentOverDueFineFreeText
Viivästyskorkoprosentti, ensisijaisesti asiakkaan laskutustiedoista ja toissijaisesti organisaation asetuksista	PaymentOverDueFinePercent

Maxtech-JÄRJESTELMÄN kenttä	XML-ELEMENTTI
Tuotenumero (tuotteen tiedoista)	ArticleIdentifier
Nimike (tuotteen tiedoista)	ArticleName
Määrä (tapahtuman laskurivin tiedoista)	InvoicedQuantity
Yksikkö (tuotteen tiedoista)	InvoicedQuantity[QuantityUnitCode]
Veroton yksikköhinta (tapahtuman laskurivin tiedoista)	UnitPriceAmount
Yksikköhinnan ja tuotteen veroprosentin perusteella laskettu verollinen hinta	UnitPriceVatIncludedAmount
Rivin järjestysnumero	RowPositionIdentifier
Kommentti laskuriville (tuotteen tiedoista)	RowFreeText
Alv% (tuotteen tiedoista)	RowVatRatePercent
Kiinteästi ’S’ (normaali ALV-käsittely)	RowVatCode
Laskurivin verojen määrä yhteensä (RowAmount-RowVatExcludedAmount)	RowVatAmount
Laskurivin veroton kokonaishinta (InvoicedQuantity * UnitPriceAmount)	RowVatExcludedAmount
Laskurivin verollinen kokonaishinta (InvoicedQuantity * UnitPriceVatIncludedAmount)	RowAmount