Before a sales invoice can be retrieved, a list of sales invoices must be requested for the id of the wanted invoice. With the id, specific information can be retrieved one at a time. When importing a sales invoice, it is recommended that the customer- and product registers are being up to date.

Sales invoices' handling operations are divided into the following resources:

IntegrationHTTP-methodResourceDTDSchemaExample
Get sales invoice or order listGETsalesinvoicelist.nv  Invoicelist
Download
Orderlist
Download
Get sales invoice or order detailsGETgetsalesinvoice.nv / getorder.nv  

Invoice
Download
Order
Download

Import sales invoice, credit invoice or orderPOSTsalesinvoice.nvDownload Download
Get sales personnel listGETsalespersonnellist.nv  Download
Delete sales invoiceGETdeletesalesinvoice.nv   
Update sales invoice statusPOSTupdatesalesinvoicestatus.nv   


Get sales invoice or order list

Resource: salesinvoicelist.nv

This resource can be used to retrieve a list of sales invoices and orders by changing the value of the ListType parameter.

Querystring parameters:

Parameter nameOccursDescriptionExample
ListType0...1Empty value if fetching sales invoice list
preinvoice if fetching order list
 
InvoicesAboveNetvisorKey0...1Includes only invoice after given id165 
BeginInvoiceDate0...1Includes only invoice after given date2012-01-01 
EndInvoiceDate0...1Includes only invoices before given date2012-12-31 
InvoiceNumber0...1Includes only invoice with given invoice number 
InvoiceStatus0...1Includes only invoice with specified status, see below what is includedopen
LastModifiedStart0...1Finds invoices that are modified after given date2012-10-23
LastModifiedEnd0...1Finds invoices that are modified before given date2012-10-24
salesinvoicebatchid 0...1 Includes only invoices with given Batch ID. See the description of the Sales Invoice Batch Handling 

InvoiceStatus parameter can have the following values:

InvoiceStatusReturns invoices with status
openOPEN, OVERDUE, REMINDED, REQUESTED, COLLECTED
overdueOVERDUE, REMINDED, REQUESTED, COLLECTED
paidPAID
unsentUNSENT
creditlossCREDITLOSS
rejectedREJECTED

Response:

LevelElement nameType and lengthOccursDescriptionExample
rootRootAggr.   
1SalesInvoiceListAggr.1  
2SalesInvoiceAggr.0...n  
3NetvisorKey Numeric 1Invoice identifier in Netvisor 123 
3InvoiceNumberString1Invoice number 1234 
3InvoiceDate Date 1Invoice date2013-11-09
Attr.formatString1Always ansiansi
3InvoiceStatusString1Status of the invoice or order. Returns sales invoice payment status.See table below.
Attr.substatusString0...1Invoice sub staus. Will return status of receivables on the invoice. This attribute is not used for orders.open, overdue, reminded, requested or collected
Attr.isincollection Numeric Is invoice in collection or not (Intrum/Duetto)

0 or 1

3CustomerCodeString1Billed customer's code 
3CustomerNameString1Customer's name 
3ReferenceNumberString1Invoice reference number 
3InvoiceSum Numeric 1Invoice sum, two decimals12,34
3OpenSum Numeric 1Open sum, two decimals12,34
3UriString1Uri that can be used to get details of invoice or orderSee below

Return value differences for orders and invoices:

 InvoiceStatusURI
Invoiceopen, creditloss, paid, rejected/getsalesinvoice.nv?netvisorkey=123
Orderarchived, undelivered, delivered, billed/getorder.nv?netvisorkey=123

 

Get sales invoice details

Recourse: getsalesinvoice.nv or getorder.nv

Before a sales invoice can be retrieved, a list of sales invoices must be requested for the id of the wanted invoice. With the id, specific information can be retrieved one at a time. If user has modified the arrangement of the invoice's invoice rows in the Netvisor user interface, request retains that arrangement.

Same resource can be used to retrieve sales order. Follows same structure as salesinvoice and same parameters can be used.

Querystring parameters:

Parameter nameOccursDescriptionExample
NetvisorKey1

Invoice identifier of the salesinvoice

125

pdfimage0...1

If the parameter is not given, the response is the same as pdfimage=lastsentprintservice
lastsentprintservice 
returns the image of the sales invoice as a PDF-file (element: LastSentInvoicePDFBase64Data) if the sales invoice is sent to the printing service
PDF

Returns the image of the sales invoice as a PDF file (element: LastSentInvoicePDFBase64Data)
nopdf
Doesn't return anything

pdf

showprocesshistory0...1Returns the sending and printing history of the sales invoice in ProcessHistory-element1
includeattachments0...1Returns all the attachments in Base64-encoding1
showcommentlines0...1Returns invoice's comment rows inside Invoiceline aggregate1
NetvisorKeyList0...1Can be used to get the full details of several invoices with given id. Max. 500 identifiers1,2,3
includedocuments0...1

 When getting salesinvoice, returns orders related to the invoice.
 When getting salesorder, returns invoices related to the order. 

1

Example: getsalesinvoice.nv?netvisorkey=1234&pdfimage=pdf&showprocesshistory=1
Example: getsorder.nv?netvisorkey=1234&pdfimage=pdf&showprocesshistory=1

Response:

LevelElement nameType and legthOccursDescriptionExample
rootRootAggr.1  
1SalesInvoiceAggr.1  
2SalesInvoiceNetvisorKeyString1Invoice Netvisor ID 
2SalesInvoiceNumberString1Invoice number 
2 SalesInvoiceDateDate1Invoice date2012-01-27
Attr.formatString1Date format, always ansiansi
2SalesInvoiceEventDateDate1Invoice event date2012-02-01
Attr.formatString1Event date format, always ansiansi
2SalesInvoiceValueDateDate 1 Invoice's Valuedate2012-01-27
Attr.formatString1Date format, always ansi ansi 
2SalesInvoiceDeliveryDateDate1Invoice's date of delivery2012-01-27
Attr.formatString1Always ansiansi
2SalesInvoiceDueDateDate1Invoice's due date2012-01-27
Attr.formatString1Always ansi ansi 
2SalesInvoiceReferencenumberString1Invoice's reference number7659221
2SalesInvoiceAmountNumeric1Invoice total124,50
Attr.iso4217currencycodeString0...1Currency used in invoice USD 
Attr.currencyrate Numeric  0...1 Currency conversion rate
0,91
2SellerIdentifierString1Indentifier of the seller (name)
Matti Meikäläinen
Attr.typeString1Always name meaning that element SellerIdentifier is name of seller name 
2InvoiceStatusString1Status of the invoice/order
 Paid 
2SalesInvoiceFreeTextBeforeLinesString1Free text before invoice lines 
2SalesInvoiceFreeTextAfterLinesString1Free text after Invoice lines 
2 SalesInvoiceOurReferenceString1Our refence
 
2SalesInvoiceYourReferenceString1Your reference 
2SalesInvoicePrivateCommentString1Comment that will not be visible on the invoice 
2SalesInvoiceAgreementIdentifierString1Contract ID
 
2InvoicingCustomerNameString1Customer's Name 
2InvoicingCustomerNameExtensionString1Customer's Name Extension 
2InvoicingCustomerNetvisorKeyString1Customer's Netvisor Key/ID 
2InvoicingCustomerOrganizationIdentifierString1Customer's Organization identifier If customer is private customer, field will be empty. 
2InvoicingCustomerAddresslineString1Customer's AddressPL 316
2InvoicingCustomerAdditionalAddressLineString1Customer's Adress, additional line 
2InvoicingCustomerPostnumberString1Customer's Post Number60123
2InvoicingCustomerTownString1Customer's City
Lappeenranta
2InvoicingCustomerCountryCodeString1Customer's Country codeFINLAND
2MatchPartialPaymentsByDefaultString1Yes or NoYes
2DeliveryAddressNameString1Name for the delivery 
2DeliveryAddressLineString1Address of the delivery 
2DeliveryAddressPostnumberString1Post number of the delivery 
2DeliveryAddressTownString1City of the delivery 
2DeliveryAddressCountryCodeString1Country code for the delivery 
2DeliveryMethodString1Method of deliveryDelivered
2DeliveryTermString1Terms of deliveryFree Deliverer
2PaymentTermNetDays String1Days for the terms of payment11
2PaymentTermCashDiscountDaysString 1Days for cash discount0
2PaymentTermCashDiscountString 1Amount of cash discount0
Attr.typeString1Always percentagepercentage
2WaybillidentifierString1Waybill number033000050143
2DeliveryToCustomerDate
String0...1Sales order delivery to customer date
2020-10-13
Attr.formatString1Delivery date format, always ansiansi
2DeliveryToCustomerWeek
String
0...1Sales order delivery to customer week42/2020
2TaxHandlingClause
String0...1Sales invoice tax handling clauseAVL 8 c §, käännetty verovelvollisuus
Attr.NetvisorKeyString1Tax handling clause's NetvisorID14
2LastSentInvoicePDFBase64DataBase640...1PDF information of previously sent invoiceS89O3Ly1Lr59NB
2InvoiceLinesAggr.1  
3InvoiceLineAggr.1  
4SalesInvoiceProductLineAggr.0...n  
5NetvisorKeyString1Id of the product line17536
5ProductIdentifierString1Id of the productTEMP1
Attr.typeString1Always customercustomer
5ProductNameString1Name of the productExample product
5ProductNetvisorKeyString1Netvisor Key/ID of the product 
5ProductUnitPriceNumeric1Unit price of the product7,00
5ProductPurchasePriceNumeric1

Purchase price of the product

 
5ProductVatPercentageString1VAT percentage of the product24
Attr.VatCodeString1VAT codeKOMY
5SalesInvoiceProductLineQuantity 1Quantity of product 
5SalesInvoiceProductLineDiscountPercentage 1Discount percentage 
5SalesInvoiceProductLineFreeTextString1Free text for line 
5SalesInvoiceProductLineVatSumNumeric 1Line vat sum rounded to two decimals1,68
5SalesInvoiceProductLineLinesumNumeric 1Line sum rounded to two decimals8,68
5SalesInvoiceProductLineInventoryIDNumeric1Warehouse ID of product1
5SalesInvoiceProductLineInventoryNameString1Warehouse name of productExample warehouse
5AccountingAccountSuggestionString1Posting suggestion551
5dimension 0...n  
6dimensionnameString1Dimension headerCity
6dimensionitemString1Dimension nameHelsinki
5ProvisionPercentageNumeric1Provision percentage12
5SalesInvoiceCommentLineAggr.0...n  
6CommentString1Comment lineComment 
2SalesInvoiceAttachmentsAggr.0...1  
3SalesinvoiceAttachmentAggr.1...n  
3mimetypeString1Contents file formatimage/jpeg
3attachmentdescriptionString1Description of attachment 
3filenameString1FilenameExample_picture.jpg
3documentdataBase641Attachment in Base64-encodingS89O3Ly1Lr59NBS89
2documentsAggr.1Invoices/orders related to the order/invoice 
3salesorderAggr.1...nNote! If getorder.nv is used, the element name is salesinvoice 
4netvisorkeyNumeric1Netvisor ID of order related to the invoice /
Netvisor ID of invoice related to the order
12345
4ordernumberNumeric1

Number of order related to the invoice /
Number of invoice related to the order
Note! If getorder.nv is used, the element name is invoicenumber

1001

 

Import sales invoice, credit invoice or order

Resource: salesinvoice.nv

The API makes it possible to add or edit a sales invoice, it's product- and comment lines, attachments, voucher lines and customer specific fields in Netvisor.

The required fields for importing a sales invoice are:

  • Date of the invoice
  • Sum total
  • Invoice status
  • Customer's linking information
  • Net day of the terms of payment or due date
  • At least one invoice line with the following information
    • Product linking information
    • Product name
    • Product's unit price
    • Product's VAT percentage and code
    • Product's unit count

The salesinvoice can be imported as a salesinvoice draft with status "invoicedraft". It is not possible to give invoice number or import invoice voucherlines for invoice drafts. Invoice draft can be updated to salesinvoice with the parameter edit.

Credit invoice is imported trough the API with the same message structure. The only difference is that unit count and sum total are set to negative numbers. Also productline vat sum and productline sum are set to negative numbers if they are given. Credit invoice is not automatically focused to existing sales invoice. Connecting credit invoice and sales invoice must always be done manually.

Netvisor rounds invoice line rowsum and invoice total sum by 2 digits when importing XML

Billing and delivery customer is focused to sales invoice by Netvisor key or by customer code. Netvisor key is database ID and customer code is individual code given in customer register by Netvisor user. These can be fetched by using customerlist.nv resource.

When only Invoicingcustomeridentifier is given in the Sales Invoice XML and no other invoicing address or delivery address details are on the XML, the API will retrieve this information automatically from customer register. In other hand if any other billing customer detail (i.e. postal address) is given, nothing is retrieved from the customer register.

If an alternative billing customer has been determined to target customer, the API will automatically retrieve the alternative customers information to the imported invoice. In this case, the billing address information in the imported material is not used.

Querystring parameters:

Parameter nameOccursDescriptionExample
Method1add or edit. When using method edit, all original order/invoice details must be given if wish to keep them.Add
Id0...1Must be defined if method = edit 

The following describes the XML message to import (POST) a purchase order into Netvisor:

LevelElement nameType and lengthOccursDescriptionExample
RootrootAggr.1  
1salesinvoiceAggr.1  
2salesinvoicenumberNumeric max. length 15 digits0...1If number is not given, Netvisor automatically picks next free number. Cannot be given for invoice drafts.  123456
2salesinvoicedate Date  2019-12-31
Attr.formatString1 ansi
2salesinvoiceeventdateDate0...1Invoice's event date. This forms the voucher date.2020-01-01
Attr.formatString1Always ansiansi
2salesinvoicevaluedateDate0...1Invoice's valuedate. If given, the net days of payment term are applied to the valuedate2009-12-31
Attr.formatString1Always ansi2009-12-31
2salesinvoicedeliverytocustomerdateDate or week number0...1Delivery date for customer. Date or week number. For sales order only.2018-W12
Attr.formatString Delivery date for customer, formatansi
Attr.type String 1 Delivery date for customer. date or weeknumber  weeknumber 
2salesinvoicewaybillidentifier
  String, max. 35 characters  0...1Waybill number/identifier. For sales order only.33000050143
2salesinvoiceproductpackagepallet
 Number 0...1Sales order package. For sales order only.2
Attr.typeString1Pallet code type, GS1GS1
Attr.amountString0...1Pallet amount2
2salesinvoiceduedate Date 1Invoice due date, mandatory if payment term is not given. Message cannot have both due date and payment term, only one can be given.2017-21-31
Attr.formatString1Invoice due date formansi
2salesInvoicedeliverydate Date 0...1Invoice delivery or arrival date2009-12-31
Attr.formatString1 ansi
2salesinvoicereferencenumber Referencenumber 0...1Invoice reference number. Must be in correct format with checksum1070
2salesinvoiceamount Numeric 1

Total amount of the invoice.
If given, amount is not calculated from the invoice rows.

Possible to give as empty value </salesinvoiceamount>, then the amount is calculated from the invoice rows

Notice that if you are importing already sent invoices, we recommend that you give the amount.

100,99

Attr.iso4217currencycodeString0...1If not given, currency code from company´s information is used. Otherwise code must be given in ISO 4217 standard
USD
Attr.currencyrateString0...1If not given, daily currency rate from European central bank is used. If there is no existing currency rate value, then value 1 used automatically1,33
Attr.pricetypeString0...1netvisor or customer. Customer does nothing but if value is netvisor, Netvisor's price groups and customer prices will be used for invoice rows. SalesInvoiceAmount -value should be 0 so that invoice amout is calculated correctly from invoice rows.netvisor
2SellerIdentifierString0...1Id of seller in Netvisor. Name of the seller can be given separately in element sellername1
Attr.typeString1Use netvisornetvisor
2sellername  String, max. length 50  0...1Free form name of the sellerMatti Mallikas
2invoicetypeString0...1

Invoice, Order or invoicedraft.
Default is invoice

Invoice

2salesinvoicestatusString1Status of invoice
Open or Unsent for invoice,
delivered or undelivered for order
Open
Attr.typeString1Use netvisornetvisor
2salesinvoicefreetextbeforelinesString, max. length 500 0...1 Free text before before invoice lines  
2salesinvoicefreetextafterlines  String, max. length 500  0...1Free text after invoice lines  
2salesinvoiceourreference  String, max. length 200  0...1Information for "our reference" field  
2salesinvoiceyourreference  String, max. length 200  0...1Information for "your reference" field  
2salesinvoiceprivatecomment  String, max. length 255  0...1Shown only in Netvisor interface, not printed on invoice form 
2InvoicingcustomeridentifierString1Information used to link invoicing customer to invoice. Customer must be already in Netvisor. Value can be customer code or id of customer record in Netvisor (see type attribute)MM
Attr.typeString1

 Type of link: netvisor (=Netvisor ID), customer (=customer code), or organizationunitnumber (=OVT-identifier) 

customer
Attr.contactpersonidString0...1

Customer's contact person's Netvisor ID. Can be retreived with getcustomer.nv.

4012
2invoicingcustomernameString, max. length 2500...1Will not be collected from NetvisorMatti
2invoicingcustomernameextensionString, max. length 250 0...1Will not be collected from NetvisorMeikäläinen
2invoicingcustomeraddresslineString, max. length 100 0...1Will not be collected from NetvisorPajukuja 1
2invoicingcustomeradditionaladdresslineString, max. length 1000...1Will not be collected from Netvisor 
2invoicingcustomerpostnumberString, max. length 50 0...1Will not be collected from Netvisor53100
2invoicingcustomertownString, max. length 50 0...1Will not be collected from NetvisorLappeenranta
2invoicingcustomercountrycodeString0...1In ISO 3316 format. *)FI
Attr.typeString1Will not be collected from NetvisorISO-3316
2deliveryaddressNameString, max. length 250 0...1Will not be collected from NetvisorMaija
2deliveryaddresslineString, max. length 100 0...1Will not be collected from NetvisorPajukuja 2
2deliveryaddresspostnumberString, max. length 50 0...1Will not be collected from Netvisor55100
2deliveryaddresstownString, max. length 50 0...1Will not be collected from NetvisorImatra
2deliveryaddresscountrycodeString0...1Will not be collected from NetvisorFI
Attr.typeString1Will not be collected from NetvisorISO-3316
2deliverymethodString, max. length 50 0...1Free form text. If given value is not found from Netvisor, then value is created as new delivery method in NetvisorInstalled
2deliverytermString, max. length 50 0...1Free form text. If given value is not found from Netvisor, then value is created as new delivery term in NetvisorAccording to agreement
2salesinvoicetaxhandlingtypeString0...1

countrygroup, forcedomesticdomesticconstructionservice or notaxhandling. *1)

If not given, taxhandlingtype from customer's information will be used

countrygroup
2paymenttermnetdaysNumeric 1Invoice date + paymenttermnetdays = invoice duedate.
Payment term: "14 days net"
14
2paymenttermcashdiscountdaysNumeric 0...1Cash discount days for the payment term. Payment term: "14 days net, 5 days" 5
2paymenttermcashdiscountNumeric 0...1  Cash discount percent. Payment term: "14 days net, 5 days- 10%"   10 
Attr.typeString1Type of discount, always percentagepercentage
2expectpartialpaymentsNumeric 0...11 = yes, 0 = no. Default 0. If the invoice accepts partial payments, the invoice is also accepting payments outside the the cash discount tolerances1
2overridevouchersalesreceivablesaccountnumberNumeric0...1When given, this will override the default sales receivables account number in Netvisor 1703   
2salesinvoiceagreementidentifierString, max. length 350...1Contract ID 
2printchannelformatString0...1  
Attr.typeString 1netvisor or customernetvisor
2secondnameString 0...1supplementary firm nameExample name
Attr.typeString 1netvisor (NetvisorKey) or customer (name)customer
2overriderateofoverdueNumeric0...1Penalty interest-%, overrides Netvisor default5,5
2invoicelinesAggr.1  

Invoice lines can be either product lines or comment lines. Product in a product line must exist in Netvisor and be linked to the line either with Netvisor-key or customer specific key. However product name, price and other information can be altered. VAT -rate must be specified for the product line. If the imported invoice has both product- and comment lines, their order will be the same as in the imported material.

If product lines are needed, structure for InvoiceLine aggregate is this:

LevelElement nameType and lengthOccursDescriptionExample
3invoicelineAggr.1...n  
4salesinvoiceproductlineAggr.1  
5productidentifierString1Product identifier, either netvisorkey or given product code. Product must be founded in Netvisor.
 
Attr.typeString1

Type of indentifier:
- customer (given product code)
- netvisor (netvisorkey)
- primaryeancode
(given primary EAN-code)
- secondaryeancode
(given secondary EAN-code)

netvisor

5productnameString, max. 2000...1Name of the product. If not given will be retrieved from Netvisor.test product
5productunitpriceNumeric1Product unit price, not retrieved from Netvisor10,05
Attr. String1Type of unit price, net or grossnet
5productunitpurchasepriceNumeric0...1Product unit purchase price1,05
Attr.typeString1Type of unit purchase price, always netnet
5productvatpercentageNumeric1Must not conflict with vat code22
Attr.vatcodeString1NONE, KOOS, EUOS, EUUO, EUPO, 100, KOMY, EUMY, EUUM, EUPM312, EUPM309, MUUL, EVTO, EVPO, RAMY, RAOS or EVROKOMY
5salesinvoiceproductlinequantityNumeric1Amount of products. Can be integer or decimal. Max two decimals (e.g. 3,55)5
5salesinvoiceproductlinediscountpercentageNumeric0...1Discount percentage10
5salesinvoiceproductlinefreetextString, max. 2550...1Free text for the product line 
5salesinvoiceproductlinevatsumNumeric0...1Tax for the product line. Given if amount calculated by Netvisor is wished to be overridden 11,00
5salesinvoiceproductlinesumNumeric0...1Line's gross total sum. Given if sum calculated by Netvisor is wished to be overridden50,00
 Note! Both salesinvoiceproductlinesum and salesinvoiceproductlinevatsum elements are required if sum calculated by Netvisor is wished to be overridden.
5salesinvoiceproductlineinventoryidNumeric0...1Warehouse ID of productline1
5accountingaccountsuggestionNumeric0...1Suggestion for accounting account. Must be found in the system3000
5skipaccrualNumeric0...1Should the line be skipped in accruals. By default all lines will be included1
5dimension 0...n  
6dimensionnameString, max. 501Dimension 
6dimensionitemString, max. 2001Dimension name 
5provisionpercentage Numeric0...1Provision percentage12
5accrualruleAggr. 0...1 Accrual rule for invoice row, you can use equal division OR allocation curve. Invoicestatus has to be "open", that the voucher is generated. 
6startmonthNumeric1Starting month9
6startyearNumeric1Starting year2019
6endmonthNumeric 0...1 Ending month (only with equal division)12
6endyearNumeric 0...1 Ending year (only with equal division)2019
6divisioncurvenameString 0...1 Allocation curve (only with allocation curve)
Has to be predefined in Netvisor view: 'Financials > Budgeting settings > Allocation curves'
 quarter
5productunitnameString, max 140...1Product unit. If not given, Netvisor will use the product unit from product details in Netvisor. Cannot be given if the compay is using Extended product management.pcs

If comment lines are needed, use the following structure for InvoiceLine aggregate:

LevelElement nameType and lengthOccursDescriptionExample
3invoicelineAggr.1...n  
4salesinvoicecommentlineAggr.1  
5commentString1 Comment for the invoice  Comment for the invoice 

After the invoice lines, the structure continues as follows:

LevelElement nameType and lengthOccursDescriptionExample
2invoicevoucherlinesAggr.0...1*2 
3voucherlineAggr.1...n  
4linesum Numeric 1Line sum. Positive value will be recorded as debit, and negative as credit 100
Attr. typeString1Type of sum, net or grossnet
4description String, max. 255 0...1Free description text  
4accountnumberString1Account number, must be found in the system 3000
4vatpercent Numeric 1VAT percent. Must not conflict with VAT code 22
Attr.vatcode Numeric 1NONE, KOOS, EUOS, EUUO, EUPO, 100, KOMY, EUMY, EUUM, EUPM312, EUPM309, MUUL, EVTO, EVPO, RAMY, RAOS or EVROKOMY
4skipaccrual Numeric 0...1Will the line be skipped in accrual. Assumed that no lines will be skipped. 
5dimensionAggr.0...n  
6dimensionnameString1 Dimension name  Project 1  
6dimensionitemString1Dimension item Payroll
2salesinvoiceaccrualAggr.0...1  
3overridedefaultsalesaccrualaccountnumber Numeric 0...1Override default accrual account. Must be found in the system 
3salesinvoiceaccrualtypeString0...1  
3accrualvoucherentryAggr.1...n

Invoice accrual (Alternative to the element accrualrule, this is the old way)

 
4monthNumeric1Accrual month. Accrual voucher will be recorded on the last day of the chosen month of the chosen year 10
4yearNumeric 1Accrual Year 2014
4sum Numeric 1Sum of the lines  
2accrualrule Aggr. 0...1

Accrual rule for the whole invoice, you can use equal division OR allocation curve. Invoicestatus has to be "open", that the voucher is generated.
(Alternative to the element accrualvoucherentry, this is the recommended way)

 
3stratmonth Numeric 1Starting month9
3startyear Numeric 1Starting year2019
3endmonth Numeric 0...1Ending month (only with equal division)12
3endyear Numeric 0...1Ending year (only with equal division)2019
3divisioncurvenameString0...1Allocation curve (only with allocation curve)
Has to be predefined in Netvisor view: 'Financials > Budgeting settings > Allocation curves'
quarter
2salesinvoiceattachmentsAggr.0...1  
3salesinvoiceattachmentAggr.1...n  
4mimetypeString1MIME type of the attachment Application/pdf 
4attachmentdescriptionString1Description of the attachment  
4filenameString1Filename of the attachment  project1.pdf 
4documentdataString1Base64 encoded data of the attachment  
Attr.typeString1

By default is used the pdf, if the attribute is not provided.

Values:
finvoice, Files to be attached to electronic invoice

pdf, Files to be attached for printing

pdf

4printbydefault Numeric 0...1

NOTE! Is not given if the attachment type is Finvoice (otherwise the request is rejected)

1= true, 0 = false

1


1*) If value is other than DomesticConstructionService is used in SalesInvoiceTaxHandling field, then value of this field is overriden with value DomesticConstructionService if invoice contains at least one line containing tax code Construction_Service_Sales. All lines in invoice must have same tax code.

2*) While importing a sales invoice, the material can include separate voucher lines, if the voucher is wanted to be formed manually. The system will use the voucher lines of the imported material, and not form voucher lines automatically if they have been included. The voucher lines in sales invoice are similar to those in Get Accounting Data request.


Delete sales invoice

Resource: deletesalesinvoice.nv

This resource differs from others by it doesn't need XML message to work. Request is transferred in URI.

With this resource it is possible to remove sales invoice or sales order and its attachments, dimension links, vouchers and etc.

Querystring parameters:

Parameter nameOccursDescription
invoiceid1Invoice Netvisor ID
orderid0...1Sales order Netvisor ID


Update sales invoice status

Resource: updatesalesinvoicestatus.nv

This resource differs from others by it doesn't need XML message to work. Request is transferred in URI.

With this resource it is possible to update one or multiple sales invoice statuses. If status is update to any other state than "unsent", sales invoice voucher is created automatically.

Querystring parameters:

Parameter nameOccursExampleDescription
netvisorkey1145Invoice Netvisor ID
netvisorkeylist0...11, 2, 3Invoices Netvisor ID list separated with comma
status1open

To which status invoice/invoices will be set
- open
- overdue
- reminded
- requested
- collected
- paid
- creditloss
- unsent


 


xml
(456 Bytes)
xml
(886 Bytes)
xml
xml
xml
(4.35 KB)
xml

Oliko tästä vastauksesta apua? Kyllä Ei

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.