Reference Data

The taxes, NRS codes, and NRS reference lists an e-invoice payload is built from

These endpoints return the values an invoice payload is built from. Each is a GET under /api/v1/e-invoicing/ with no parameters, and each needs the same access as the rest of e-invoicing: e-invoicing on the business's plan and NRS setup completed in Duplo Dashboard, or the call returns 403.

Values you send on an invoice

EndpointEach itemUse it for
GET /taxesname, rateAn item's taxes. Send an NRS category's name and rate as they are
GET /product-codescode, descriptionAn item's hsnCode, which only accepts the NNNN.NN form
GET /service-codescode, descriptionAn item's isicCode

/taxes lists the taxes set up for your business first, then the NRS tax categories that have a published rate, with rate in percentage points (7.5 for 7.5% VAT). An NRS category's name is its category code, such as STANDARD_VAT, and that code is what NRS expects as the tax name.

NRS reference lists

EndpointEach item
GET /tax-categoriescode, value, percent
GET /quantity-codescode, name, description
GET /countriesAs NRS publishes it
GET /currenciesAs NRS publishes it
GET /payment-meansAs NRS publishes it
GET /invoice-typesAs NRS publishes it
GET /vat-exemptionsAs NRS publishes it

/tax-categories is the full NRS list, including categories whose percent is blank or Not Available. /taxes leaves those out.

You never send a quantity code: an item's unit takes a fixed value such as Hour or Pieces, and Duplo converts it to the matching NRS code.

NRS's countries list is reference data only. For the country and state on a customer or on supplierData, use the countries endpoints.

How is this guide?

Last updated on

On this page