Requests are sent to specific resources (URI) which handles them. Request path contains fixed part like https://isvapi.netvisor.fi/ and name of the resource like accounting.nv. So full path to resource is http://isvapi.netvisor.fi/Accounting.nv.

Requests may use query strings as parameters to define what kind of data should be returned or what kind of operation is performed for incoming data payload.

Depending on the integration resource, request might need some payload to be sent to server or no payload at all. Each integration resource defines if it needs inbound payload. Usually the integration resource which is used to import data to Netvisor requires inbound payload data. Inbound data is placed on request body.

Request payload contains element <Root> as root element. Inside this stands all data related to request.

Request must be in UTF-8 encoded format. XML declarations are not needed, because our service end is making the needed preparations for contents and is writing needed declaration self.

Below is an example how this is handled in our WS Client:

An example:
Host: isvapi.netvisor.fi
User-Agent: libwww-perl/6.02
Content-Type: text/plain
X-Netvisor-Authentication-CustomerId: AM_YYYY_XX
X-Netvisor-Authentication-TransactionId: 12345
X-Netvisor-Authentication-MAC: 98fa03c25cXXX3812f44e4XXXXXXX
X-Netvisor-Authentication-PartnerId: NetvisorTestPartner
X-Netvisor-Authentication-Sender: Netvisor test client
X-Netvisor-Authentication-Timestamp: 2016-2-26 13:49:12.221
X-Netvisor-Interface-Language: EN
X-Netvisor-Organisation-ID: 22990XX-8
Content-Length: 1467
 
<Root>
    <SalesInvoice>
        <SalesInvoiceDate format="ansi">2016-01-15</SalesInvoiceDate>
        <SalesInvoiceAmount>124</SalesInvoiceAmount>
        <InvoiceType>invoice</InvoiceType>
        <SalesInvoiceStatus type="netvisor">unsent</SalesInvoiceStatus>
        <InvoicingCustomerIdentifier type="customer">temp</InvoicingCustomerIdentifier>
        <InvoicingCustomerName>Netvisor</InvoicingCustomerName>
        <InvoicingCustomerAddressLine>PL 316</InvoicingCustomerAddressLine>
        <InvoicingCustomerPostNumber>60123</InvoicingCustomerPostNumber>
        <InvoicingCustomerTown>Lappeenranta</InvoicingCustomerTown>
        <PaymentTermNetDays>11</PaymentTermNetDays>
        <ExpectPartialPayments>1</ExpectPartialPayments>
        <InvoiceLines>
            <InvoiceLine>
                <SalesInvoiceProductLine>
                    <ProductIdentifier type="customer">Temp</ProductIdentifier>
                    <ProductName>Temp product</ProductName>
                    <ProductUnitPrice type="net">7</ProductUnitPrice>
                    <ProductVatPercentage vatcode="KOMY">24</ProductVatPercentage>
                    <SalesInvoiceProductlineQuantity>1</SalesInvoiceProductlineQuantity>
                    <AccountingAccountSuggestion>3000</AccountingAccountSuggestion>
                </SalesInvoiceProductLine>
            </InvoiceLine>
        </InvoiceLines>       
        </SalesInvoice>
</Root>




Did you find it helpful? Yes No

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