Försäljnings- och inköpsbetalningar samt funktionerna för hantering av gireringar fördelar sig på följande resurser:
| Integration | HTTP-metod | Resurs | DTD | Schema | Exempel |
| Hämta försäljningsbetalningslista | GET | salespaymentList | Ladda ner | ||
| Importera försäljningsbetalning | POST | salespayment.nv | salespayment.dtd | Ladda ner | |
| Ta bort försäljningsbetalning | POST | deletesalespayment.nv | - | ||
| Hämta inköpsprestaion | GET | paymentlist.nv | Ladda ner | ||
| Hämta gireringsstatus | GET | unprocessedoutgoingpayments.nv | Ladda ner | ||
| Importera girering | POST | payment.nv | payment.dtd | Ladda ner |
Hämta inköpsbetalning
Resurs: salespaymentlist.nv
Resurs för att hämta försäljningsbetalningslistan.
Parametrar som används i anropet:
| Parameter | Förekomster | Beskrivning | Exempel |
| abovenetvisorkey | 0...1 | Begränsa värdet på sökta betalningars ID till större än givet värde | |
| begindate | 0...1 | Datumbegränsning från | 2015-10-23 |
| enddate | 0...1 | Datumbegränsning till | 2015-10-24 |
| searchbyname | 0...1 | Söker på betalningens namn | |
| limitlinkedpayments | 0...1 | Filtrerar på basis av fakturalänkning 0 = betalningen saknar länkad faktura 1 – betalningen måste ha en länkad faktura | 0 |
| limitbytype | 0...1 | Begränsar enligt betalningstyp excludecreditloss – listar bara kreditförluster excludecreditloss – listar alla andra förutom kreditförluster | excludecreditloss |
| lastmodifiedstart | 0...1 | Hämtar försäljningsbetalningar som ändrats efter angivet datum. I formatet yyyy-MM-ddTHH:mm:ss | 2019-12-10T12:00:00 |
| lastmodifiedend | 0...1 | Hämtar försäljningsbetalningar som har ändrats före angivet datum. I formatet yyyy-MM-ddTHH:mm:ss | 2019-12-20T12:00:00 |
Svar:
| Nivå | Element | Form | Förekomster | Beskrivning | Exempel |
| root | Root | Aggregat | 1 | ||
| 1 | SalespaymentList | Aggregat | 1 | ||
| 2 | SalesPayment | Aggregat | 0...n | ||
| 3 | NetvisorKey | Numerisk | 1 | Betalningens Netvisor-nyckel | |
| 3 | Name | Teckensträng | 1 | Betalarens namn | |
| 3 | Date | Datum | 1 | Betalningsdatum | |
| 3 | Sum | Numerisk | 1 | Betalningens belopp | |
| 3 | ReferenceNumber | Teckensträng | 1 | Betalningens referensnummer | |
| 3 | ForeignCurrencyAmount | Numerisk | 1 | Fakturans valutasumma | |
| 3 | InvoiceNumber | Numerisk | 1 | Fakturans nummer | |
| 3 | PaymentAccountName | Teckensträng | 1 | Betalarens banks/betalningssätts namn | Kontant |
| 3 | PaymentAccountNumber | Teckensträng | 1 | Betalningens kontonummer om det fanns ett bankkonto | FI12 3456 xxx |
| 3 | BankStatus | Teckensträng | 1 | Betalningens bankstatus. OK eller FAILED | OK |
| 3 | BankStatusErrorDescription | Teckensträng | 0...1 | Felbeskrivning | |
| Attr. | code | Teckensträng | 0...1 | Felkod |
Förklaring av bankstatusens felkoder:
| NO_ACCOUNT_FOUND | Kontot finns inte |
| NO_PAYMENT_SERVICE_ACCOUNT | Inte ett betaltjänstkonto |
| ERROR_IN_DUE_DATE | Felaktig förfallodag |
| BALANCE_IS_EXCEEDED | Inte debiterad |
| PAYER_HAS_CANCELED | Återkallad av betalaren |
| FORM_NOT_CORRECT | Formfel |
| BANK_HAS_CANCELLED | Banken har återkallat |
| CANCELLATION_NOT_CLEARING | Annullering fördelas inte |
| AUTHORIZATION_IS_MISSING | Fullmakt saknas |
Importera försäljningsbetalning
Resurs: salespayment.nv
Resurs för att hämta försäljningsbetalningslistan. Betalningen kan fördelas till en försäljningsfaktura eller försäljningsorder.
Tilldelningen av en betalning till en försäljningsfaktura eller order kan göras med NetvisorKey, ett faktura-/ordernummer eller ett referensnummer. Försäljningsfakturan/försäljningsordern måste existera innan du kan skapa en betalning för den. Om betalningen importerats före försäljningsfakturan fördelas den inte längre automatiskt. Försäljningsbetalningen kopplas inte heller automatiskt till försäljningsfakturan om fakturan har Betalad-status.
Om den försäljningsfaktura för vilken försäljningsbetalningen importeras tar emot delbetalningar läggs betalningen alltid till som en exakt summa. Om försäljningsfakturan inte godkänner delbetalningar måste betalningens summa hålla sig inom toleransen för försäljningsfakturans kassarabatt.
Om du vill importera en försäljningsbetalning för en oskickad faktura måste försäljningsfakturan acceptera delbetalningar för att försäljningsbetalningen ska koppas korrekt till fakturan. Inställningen definieras antingen via försäljningsfakturans meddelande, om fakturan importeras över gränssnittet, eller i användargränssnittets grundinställningar för försäljningen.
Du kan importera en försäljningsbetalning till en försäljningsorder, varvid den redovisas som förskottsbetalning för ordern. När en faktura skapas för en order överförs förskottsbetalningar som betalningar till fakturan. Om hela summan importeras till fakturan och en faktura skapas för ordern blir fakturans status automatiskt "Betald".
En inköpsbetalning som ska importeras skickas med anropet som XML (POST-data) enligt beskrivningen nedan.
| Nivå | Element | Form | Förekomster | Beskrivning | Exempel |
| root | root | Aggregat | 1 | ||
| 1 | salespayment | Aggregat | 1 | ||
| 2 | sum | Numerisk | 1 | Försäljningsbetalningens belopp | 10,00 |
| Attr. | currency | Teckensträng | 1 | Valutakod, om denna inte hittas i systemet returneras INVALID_DATA med förklaringar | EUR |
| 2 | paymentdate | Datum | 1 | Betalningsdatum | 2009-9-5 |
| 2 | targetidentifier | Teckensträng | 1 | Fakturans fördelningsuppgift | 1070 |
| Attr. | type | Teckensträng | 1 | Typ av tilldelningsuppgift, netvisor, reference eller invoicenumber | invoicenumber |
| Attr. | targettype | Teckensträng | 0...1 | Suorituksen kohditus, invoice tai order | Order |
| 2 | sourcename | Teckensträng | 1 | Betalningskällans namn | Pekka Paajanen |
| 2 | paymentmethod | Teckensträng | 1 | Betalningssätt. Betalningssättets namn eller bankkontots kontonummer i IBAN-format bör hittas i Netvisor. | bankkort |
| Attr. | type | Teckensträng | 1 | Typ av betalningssätt: alternative eller bankaccount | alternative |
| Attr. | overrideaccountingaccountnumber | Numerisk | 0...1 | Om objektets ID inte hittas returneras felet INVALID_DATA med förklaring. | 1900 |
| Attr. | overridesalesreceivableaccountnumber | Numerisk | 0...1 | Överskrivning av verifikatets försäljningskonto | 2100 |
| 2 | salespaymentvoucherlines | Aggregat | 0...n | Försäljningsbetalningens verifikationsuppgifter | |
| 3 | voucherline | Aggregat | 1...n | Verifikationsrad | |
| 4 | linesum | Numerisk | 1 | Radsumma | 10,00 |
| Attr. | type | Teckensträng | 1 | Anger om radsumman inkluderar skatt, net (skattefritt pris) eller gross (pris inklusive skatt) | gross |
| 4 | description | Teckensträng | 0...1 | Radbeskrivning | Försäljningstransaktion |
| 4 | accountnumber | Numerisk | 1 | Kontots nummer | 1500 |
| 4 | vatpercent | Numerisk | 1 | Skatteprocent | 24 |
| Attr. | vatcode | Teckensträng | 1 | Momskod *1 | KOMY |
| 4 | dimension | Aggregat | 0...n | NULL | |
| 5 | dimensionname | Teckensträng | 1 | Räkenskapsobjektsrubrik | Kontantköp |
| 5 | dimensionitem | Teckensträng | 1 | Räkenskapsobjektets namn | Försäljning |
*1) NONE, KOOS, EUOS, EUUO, EUPO, 100, KOMY, EUMY, EUUM, EUPM312, EUPM309, MUUL, EVTO, EVPO
Se även Momsbehandling och momskoder
| Momskod | MOMS-kod | Momsprocent |
| Ingen momsbehandling | NONE | 0 |
| Inrikesförsäljning | KOMY | 0, 10, 14, 24 |
| EU-försäljning | EUMY | 0 |
| Försäljning utanför EU | EUUM | 0 |
| Inrikesinköp | KOOS | 0, 10, 14, 24 |
| EU-inköp | EUOS | 0, 10, 14, 24 |
| EU-tjänsteinköp | EUPO | 0, 10, 14, 24 |
| Inköp utanför EU | EUUO | 0, 10, 14, 24 |
| 100 % | 100 | 0 |
| För transaktioner efter 1.1.2010 kan följande momskoder som behövs för periodskattedeklarationen användas: | ||
| 312 EU-tjänsteförsäljning | EUPM312 | 0 |
| 309 EU-tjänsteförsäljning | EUPM309 | 0 |
| Övrig momsfri omsättning (310) | MUUL | 0, 10, 14, 24 |
| Varuinköp från andra EU-länder, inte avdragsgillt | EVTO | 0, 10, 14, 24 |
| Tjänsteinköp från andra EU-länder, inte avdragsgillt | EVPO | 0, 10, 14, 24 |
| Försäljning av byggtjänster | RAMY | 0 |
| Köp av byggtjänster | RAOS | 0, 10, 14, 24 |
| Ej avdragsgillt köp av byggtjänster | EVRO | 0, 10, 14, 24 |
Ta bort försäljningsbetalning
Resurs: deletesalespayment.nv
Med resursen kan du ta bort en befintlig försäljningsbetalning. Det är inte tillåtet att ta bort betalningar för referensbetalningar och låsta perioder.
Parametrar som används i anropet:
| Parameter | Förekomster | Beskrivning |
| paymentid | 1 | NetvisorKey för betalning som tas bort |
Hämta inköpsbetalning
Resurs: paymentlist.nv
Med resursen kan du hämta inköpsfakturans betalningsuppgifter och kontrollera om inköpsfakturan har betalats eller inte.
Parametrar (QueryString) som används i anropet:
| Parameter | Förekomster | Beskrivning | Exempel |
| limitabovenetvisorkey | 0...1 | Begränsa värdet på sökta betalningars ID till större än givet värde | |
| limitbegindate | 0...1 | Begynnelsedatum för betalningens datumbegränsning (inte förfallodatumets) | 2015-10-23 |
| limitenddate | 0...1 | Slutdatum för betalningens datumbegränsning (inte förfallodatumets) | 2015-10-24 |
| limitreference | 0...1 | Filtrerar enligt fakturans referensnummer | |
| limitinvoiceid | 0...1 | Hämtar alla betalningar för en viss inköpsfaktura | 1 |
Svar:
| Nivå | Element | Form | Förekomster | Beskrivning | Exempel |
| root | Root | Aggregat | 1 | ||
| 1 | PaymentList | Aggregat | 1 | ||
| 2 | Payment | Aggregat | 0...n | ||
| 3 | NetvisorKey | Numerisk | 1 | Betalningens Netvisor-nyckel | 1 |
| 3 | PayerName | Teckensträng | 1 | Betalningens namn | |
| 3 | Date | Datum | 1 | Betalningsdatum | |
| 3 | HomeCurrencySum | Numerisk | 1 | Betalningens belopp | |
| 3 | ForeignCurrencySum | Numerisk | 1 | Fakturans valutasumma | |
| 3 | Reference | Teckensträng | 1 | Betalningens referensnummer | 1070 |
| 3 | InvoiceKey | Numerisk | 1 | Fakturans Netvisornyckel | 1 |
| 3 | InvoiceNumber | Numerisk | 1 | Fakturans nummer | 123 |
| 3 | InvoiceURI | Teckensträng | 1 | Fakturans URI | |
| 3 | VoucherKey | Numerisk | 1 | Verifikationens NetvisorKey | 1 |
| 3 | VoucherNumber | Numerisk | 1 | Verifikationsnummer | 123 |
Hämta gireringsstatus
Resurs: unprocessedoutgoingpayments.nv
Genom att använda resursen kan du hämta statusinformation för gireringar som skickats via gränssnittet. Om betalningen är under behandling och ingen återkoppling har mottagits från banken returnerar resursen inget.
| Parameter | Förekomster | Beskrivning | Exempel |
| idlist | 1 | Hämtar status för skickade fakturor, idlist = payment.nv returnerad av resursen InsertedDataIdentifier |
Svar:
| Nivå | Element | Form | Förekomster | Beskrivning | Exempel |
| root | Root | Aggregat | 1 | ||
| 1 | Payments | Aggregat | 1 | ||
| 2 | Payment | Aggregat | 0...n | ||
| 3 | identifier | Numerisk | 1 | Betalningens Netvisor-nyckel | |
| 3 | status | Teckensträng | 1 | Betalningsstatus 2 = ok 3 = felaktig | |
| 3 | statusdescription | Teckensträng | 1 | Detaljerad felorsak |
Importera girering
Resurs: payment.nv
Via gränssnitten är det möjligt att hämta nya banköverföringar, som godkänns eller betalas via kontoöverföringsvyn i Netvisor. Banköverföringar kan göras till SEPA-områden, mottagarens kontonummer måste vara i IBAN-format. Kontonumrets riktighet kontrolleras i samband med hämtandet. BIC-kodens riktighet kontrolleras ifall Netvisor inte känner igen banken på basen av mottagarens kontonummer (bekräftade banker). I Netvisor är transkationernas valuta alltid euro.
Om ett förfallodatum i förgången tid importeras till gireringen byter Netvisor förfallodagen till den dags datum då den överförs till betalning. Det är inte möjligt att redigera en girering i Netvisor i efterskott.
Data om en girering En inköpsbetalning som ska importeras skickas med anropet som XML (POST-data) enligt beskrivningen nedan.
| Nivå | Element | Form | Förekomster | Beskrivning | Exempel |
| root | root | Aggregat | 1 | ||
| 1 | payment | Aggregat | 1 | ||
| 2 | bankpaymentmessagetype | Teckensträng | 1 | Meddelandetyp: FinnishReference = referensnummer Referensnummer/meddelande: | FinnishReference |
| 2 | bankpaymentmessage | Teckensträng | 1 | Gireringsmeddelande: referensnummer eller meddelande | 1071 |
| 2 | recipient | Aggregat | 1 | Mottagare | |
| 3 | organizationcode | Teckensträng | 0...1 | Mottagarens FO-nummer | 1234567-8 |
| 3 | name | Teckensträng | 1 | Mottagarens namn | Ville Valta |
| 3 | address | Teckensträng | 0...1 | Mottagarens adress | Valtakatu 51 |
| 3 | postcode | Teckensträng | 0...1 | Mottagarens postnummer | 53100 |
| 3 | town | Teckensträng | 0...1 | Mottagarens stad | Villmanstrand |
| 3 | country | Teckensträng | 0...1 | Mottagarens land som ISO-3166 alfa-2-kod. | |
| 2 | sourcebankaccountnumber | Numerisk | 1 | Betalarens kontonummer | FI000998874123 |
| 2 | destinationbankaccount | Aggregat | 1 | Mottagarens bankkonto | |
| 3 | bankname | Teckensträng | 1 | Mottagarens banks namn | Handelsbanken |
| 3 | bankbranch | Teckensträng | 1 | Mottagarens BIC | HANDFIHH |
| 3 | destinationbankaccountnumber | Teckensträng | 1 | Mottagarens kontonummer | FI000111234567 |
| 2 | Duedate | Datum | 1 | Förfallodag Observera dokumentation om faktorer gällande förfallodagen | 25.5.2016 |
| 2 | Amount | Numerisk | 1 | Summa | 10,00 |
Hjälpte det här svaret? Ja Nej
Send feedback