Services

A service is a delivery product configured for your account - the same options you pick from when creating an order in your panel. Each order belongs to exactly one service.

Your services

Services are set up per merchant by 4N NextDay, so the list, the codes and the names are specific to your account. Each service has:

Field	Type	Description
`id`	integer	Unique service identifier - this is what you send as `service_id`
`code`	string	Short code chosen for your account (for example `ECOM-STGO`)
`name`	string	Display name, as shown in your panel
`type`	string	`b2b`, `b2c` or `field` (see below)

Service types

Type	Meaning
`b2b`	Deliveries to businesses - stores, warehouses, offices
`b2c`	Deliveries to consumers - home delivery
`field`	Cargo created by drivers on the road from blank labels. Auto-provisioned; not for integration orders and never chosen automatically

Only active services are returned by the API. If a service you used to send disappears from the list, it was deactivated - orders with that service_id are rejected until you switch to another one.

Choose a service

When syncing an order, include the service_id - just like selecting a service in your panel:

{
  "destination_address": "Calle Secundaria 456",
  "destination_locality": "Providencia",
  "weight": 2.5,
  "service_id": 27
}

What happens with service_id:

You send	Result
The id of one of your active services	The order is created with that service
Nothing	Your account's default active service is used (never a `field` one). `422` with `There are no active services available for this merchant.` if you have none
The id of a service that isn't yours or is inactive	`422` with `The specified service is not available for this merchant.`
An id that doesn't exist at all	`422` validation error on `service_id`: `The selected service does not exist.`

Fetch the list of services

Get your active services programmatically. This endpoint requires a merchant token:

GET

/services

curl https://api.4nortes.app/api/v1/services \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json"

Response

{
  "success": true,
  "message": "Services retrieved successfully",
  "data": [
    {
      "id": 31,
      "code": "B2B-RM",
      "name": "Distribución B2B Región Metropolitana",
      "type": "b2b"
    },
    {
      "id": 27,
      "code": "ECOM-STGO",
      "name": "E-commerce Santiago",
      "type": "b2c"
    }
  ],
  "timestamp": "2025-02-03T10:00:00.000000Z"
}

Need a new service, or a service for another destination area? Contact your 4N NextDay account representative - services, coverage and pricing are configured on our side.