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
salesinvoicebatchid0...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  
3NetvisorKeyNumeric 1Invoice identifier in Netvisor123
3InvoiceNumberString1Invoice number1234
3InvoiceDateDate 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 status. Will return status of receivables on the invoice: open, overdue, reminded, requested or collected. This attribute is not used for orders.open
Attr.isincollectionNumeric Is invoice in collection or not (Intrum/Duetto)0 or 1
3CustomerCodeString1Billed customer's code 
3CustomerNameString1Customer's name 
3ReferenceNumberString1Invoice reference number 
3InvoiceSumNumeric 1Invoice sum, two decimals12,34
3OpenSumNumeric 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
NetvisorKey1Invoice identifier of the salesinvoice125
pdfimage0...1If 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 ansiansi
2SalesInvoiceDeliveryDateDate1Invoice's date of delivery2012-01-27
Attr.formatString1Always ansiansi
2SalesInvoiceDueDateDate1Invoice's due date2012-01-27
Attr.formatString1Always ansiansi
2SalesInvoiceReferencenumberString1Invoice's reference number7659221
2SalesInvoiceAmountNumeric1Invoice total124,50
Attr.iso4217currencycodeString0...1Currency used in invoiceUSD
Attr.currencyrateNumeric0...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 sellername
2InvoiceStatusString1Status of the invoice/order
Maksettu
Attr.statusString1Status code of the invoice/order:
Invoice: open, paid, unsent, overdue, reminded, requested, collected, creditloss or rejected
Order: archived, undelivered, delivered, billed
paid
2InvoiceVoucherString0...1Invoice voucher number27
Attr.NetvisorKeyString1Voucher Netvisor ID8000
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 identifierIf 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
2PaymentTermNetDaysString1Days for the terms of payment. If payment term is due date this will return empty value11
2PaymentTermCashDiscountDaysString 1Days for cash discount. If payment term is due date this will return empty value5
2PaymentTermCashDiscountString 1Amount of cash discount. If payment term is due date this will return empty value10
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
5ProductPurchasePriceNumeric1Purchase price of the product 
5ProductVatPercentageString1VAT percentage of the product24
Attr.VatCodeString1VAT codeKOMY
5SalesInvoiceProductLineQuantityNumeric1Quantity of product 
5SalesInvoiceProductLineDiscountPercentageNumeric 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
5dimensionAggr.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
4ordernumberNumeric1Number 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
2salesinvoicedateDate1Sales invoice date
2019-12-31
Attr.formatString1Always ansiansi
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 1Delivery date for customer, formatansi
Attr.typeString1Delivery date for customer. date or weeknumber  weeknumber
2salesinvoicewaybillidentifier
String, max 35 characters0...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 Date1Invoice 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
2salesInvoicedeliverydateDate0...1Invoice delivery or arrival date2009-12-31
Attr.formatString1 ansi
2salesinvoicereferencenumberReferencenumber0...1Invoice reference number. Must be in correct format with checksum1070
2salesinvoiceamountNumeric1Total 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. This is primary linkage if also element sellername is used. If given Id is not found in Netvisor, interface will return an error. 1
Attr.typeString1Use netvisornetvisor
2sellernameString, max. length 500...1Free form name of the sellerMatti Mallikas
2invoicetypeString0...1Invoice, 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...1Free text before before invoice lines  
2salesinvoicefreetextafterlinesString, max. length 5000...1Free text after invoice lines  
2salesinvoiceourreferenceString, max. length 200  0...1Information for "our reference" field  
2salesinvoiceyourreferenceString, max. length 200 0...1Information for "your reference" field  
2salesinvoiceprivatecommentString, max. length 2550...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...1Customer'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 Netvisor. Must be given if delivery details should be shown on invoice PDF.Maija
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...1countrygroup, forcedomestic, domesticconstructionservice 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...1Cash 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.typeString1netvisor (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.typeString1Type 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.typeString1Type 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 code24
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 eight decimals (e.g. 3,55555555)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
5dimensionAggr.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
6endmonthNumeric0...1 Ending month (only with equal division)12
6endyearNumeric 0...1 Ending year (only with equal division)2019
6divisioncurvenameString 0...1Allocation 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  
5commentString1Comment 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  
4linesumNumeric1Line sum. Positive value will be recorded as debit, and negative as credit 100
Attr. typeString1Type of sum, net or grossnet
4descriptionString, max. 255 0...1Free description text  
4accountnumberString1Account number, must be found in the system 3000
4vatpercentNumeric1VAT percent. Must not conflict with VAT code 24
Attr.vatcodeNumeric1NONE, KOOS, EUOS, EUUO, EUPO, 100, KOMY, EUMY, EUUM, EUPM312, EUPM309, MUUL, EVTO, EVPO, RAMY, RAOS or EVROKOMY
4skipaccrualNumeric0...1Will the line be skipped in accrual. Assumed that no lines will be skipped. 
5dimensionAggr.0...n  
6dimensionnameString1Dimension nameProject 1
6dimensionitemString1Dimension item Payroll
2salesinvoiceaccrualAggr.0...1  
3overridedefaultsalesaccrualaccountnumberNumeric0...1Override default accrual account. Must be found in the system 
3salesinvoiceaccrualtypeString0...1  
2accrualruleAggr. 0...1Accrual 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)
 
3startmonthNumeric 1Starting month9
3startyearNumeric1Starting year2019
3endmonthNumeric0...1Ending month (only with equal division)12
3endyearNumeric0...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.typeString1By 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
4printbydefaultNumeric0...1NOTE! Is not given if the attachment type is Finvoice (otherwise the request is rejected)

1= true, 0 = false
1
2customtagsAggr.0...1

3tagAggr.1...n

4tagnameString1The name of the customer additional field in NetvisorCustomer additional field name
4tag valueString1Value of the additional fieldAdditional information
Attr.typeString1Type of the additional field: float (selection list), date, text or enum (decimal number)text


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
status1openTo which status invoice/invoices will be set
- open
- overdue
- reminded
- requested
- collected
- paid
- creditloss
- unsent



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

Oliko tästä vastauksesta apua? Kyllä Ei

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