Novaposhta


A small library that provides a helper class to work with Nova Poshta API.

Usage

Install it using the following command:

``
npm i novaposhta
`

The library exports the NovaPoshta class that you need to use to make requests to API. You need to instantiate an instance of the class providing an object with configuration options. The instance of the class has getters that allows you to get access to a specific model of the APIs.

Also, please, pay attention that some API methods require API key for authorization. You can obtain it by going to this page.

Here is a basic example that shows how to use the library:

`javascript
import NovaPoshta from 'novaposhta';

const api = new NovaPoshta({ apiKey: '...' });

api.address
.getCities({ Ref: "ebc0eda9-93ec-11e3-b441-0050568002cf" })
.then((json) => {
// do something
})
.catch((errors) => {
if (Array.isArray(errors)) {
errors.forEach((error) => console.log([${ error.code || '-' }] ${ error.en || error.uk || error.ru || error.message }));
}
});
`

A bit more advanced example that demonstrates how you can configure a Winston Logger and use it with the library:

`javascript
import NovaPoshta from 'novaposhta';
import Winston from 'winston';
import WinstonFormatter from 'winston-console-formatter';

const winstonLogger = new Winston.Logger({ level: "debug" });
winstonLogger.add(Winston.transports.Console, WinstonFormatter.config());

const api = new NovaPoshta({
apiKey: '...',
logger: winstonLogger,
});

api.address.getCities({ Ref: "ebc0eda9-93ec-11e3-b441-0050568002cf" }).then((json) => {
// do something
});
`

Supported API Methods

$3

`javascript
const api = new NovaPoshta({ apiKey: '...' });

api.address.getCities({ Ref: "ebc0eda9-93ec-11e3-b441-0050568002cf" }).then((json) => {
// do something
});
`

- searchSettlements
- searchSettlementStreets
- update
- save
- getAreas
- getCities
- getSettlements
- getWarehouses
- getWarehouseTypes
- getStreet
- delete

$3

`javascript
const api = new NovaPoshta({ apiKey: '...' });

api.common.getTimeIntervals({ "RecipientCityRef": "8d5a980d-391c-11dd-90d9-001a92567626" }).then((json) => {
// do something
});
`

- getTimeIntervals
- getCargoTypes
- getBackwardDeliveryCargoTypes
- getPalletsList
- getTypesOfPayers
- getTypesOfPayersForRedelivery
- getPackList
- getTiresWheelsList
- getCargoDescriptionList
- getMessageCodeText
- getServiceTypes
- getTypesOfCounterparties
- getPaymentForms
- getOwnershipFormsList

$3

`javascript
const api = new NovaPoshta({ apiKey: '...' });

api.counterparty.getCounterpartyContactPersons({ ... }).then((json) => {
// do something
});
`

- getCounterpartyAddresses
- getCounterpartyOptions
- getCounterpartyContactPersons
- getCounterparties
- save
- update
- delete

$3


`javascript
const api = new NovaPoshta({ apiKey: '...' });

api.contactPerson.save({ ... }).then((json) => {
// do something
});
`

- save
- update
- delete

$3

`javascript
const api = new NovaPoshta({ apiKey: '...' });

api.internetDocument.getDocumentList({ ... }).then((json) => {
// do something
});
`

- getDocumentList
- getDocumentDeliveryDate
- getDocumentPrice
- getStatusDocuments
- save
- update
- delete
- generateReport

$3

`javascript
const api = new NovaPoshta({ apiKey: '...' });

api.scanSheet.getScanSheetList({ ... }).then((json) => {
// do something
});
`

- deleteScanSheet
- insertDocuments
- getScanSheet
- getScanSheetList
- removeDocuments

$3

`javascript
const api = new NovaPoshta({ apiKey: '...' });

api.additionalService.getReturnOrdersList({ ... }).then((json) => {
// do something
});
`

- delete
- getChangeEWOrdersList
- getRedirectionOrdersList
- getReturnOrdersList
- getReturnReasons
- getReturnReasonsSubtypes
- CheckPossibilityChangeEW
- CheckPossibilityCreateReturn
- save

$3

`javascript
const api = new NovaPoshta({ apiKey: '...' });

api.additionalServiceGeneral.checkPossibilityForRedirecting({ ... }).then((json) => {
// do something
});
`

- delete
- checkPossibilityForRedirecting
- save

Contribute

Want to help or have a suggestion? Open a new ticket and we can discuss it or submit a pull request. Please, make sure you run npm test` before submitting a pull request.

License

MIT