---
title: "Connect this test organization to the provider's sandbox (staff of the service only)"
description: "Adds a second connection, the provider's sandbox, with its own series `FT02` and `BT03`. The simulator, its series and their numbers are left as they are: `F001`/`B001` keep going to the simulator. The sandbox only accepts the RUC enrolled under the account of the service, so the issuer of this test organization must already carry it (PUT /v1/issuer) and the same RUC is sent here."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.invox.page/llms.txt
> Use this file to discover all available pages before exploring further.

Path: Invox API › Test mode

`POST /v1/test/provider/connect_sandbox`

Adds a second connection, the provider's sandbox, with its own series `FT02` and `BT03`. The simulator, its series and their numbers are left as they are: `F001`/`B001` keep going to the simulator. The sandbox only accepts the RUC enrolled under the account of the service, so the issuer of this test organization must already carry it (PUT /v1/issuer) and the same RUC is sent here.

## Authentication

- `bearer`, http, header `Authorization`

## Header parameters

- `X-Organization` (`post-test-provider-connect-sandbox.header.X-Organization`; string, optional) — Required with a person's access token: the organization to act on. Omit it with a service-account key.
  - format `uuid`

## Request body

_Required._

- `tax_id` (`post-test-provider-connect-sandbox.tax_id`; string, required)
  - pattern `^(10|15|16|17|20)\d{9}$`

## Example request

```json
{
  "tax_id": "20601188750"
}
```

## Code samples

### cURL

```bash
curl --request POST \
  --url https://api.invox.page/v1/test/provider/connect_sandbox \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tax_id": "20601188750"
}
'
```

### TypeScript

```typescript
const url = 'https://api.invox.page/v1/test/provider/connect_sandbox';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({tax_id: '20601188750'})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.invox.page/v1/test/provider/connect_sandbox"

payload = { "tax_id": "20601188750" }
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
```

## Responses

### 200

It was already connected: the existing connection and its series.

#### Example

```json
{
  "object": "sandbox_connection",
  "connection": {
    "id": "string",
    "object": "provider_connection",
    "provider": "simulator",
    "mode": "simulator",
    "status": "active",
    "series": [
      "string"
    ],
    "account": {
      "status": "ok",
      "scope": "platform",
      "code": "provider_account_suspended",
      "since": "string",
      "summary": "string"
    },
    "created_at": "string"
  },
  "series": [
    {
      "id": "string",
      "code": "string",
      "document_type": "factura",
      "establishment": "string",
      "last_number": -9007199254740991,
      "next_number": -9007199254740991,
      "last_issued": {
        "number": -9007199254740991,
        "invoice_id": "string",
        "status": "processing",
        "issued_at": "string"
      },
      "status": "string",
      "created_at": "string"
    }
  ],
  "what_next": "string"
}
```

- `object` (`post-test-provider-connect-sandbox.response.200.object`; string, required)
- `connection` (`post-test-provider-connect-sandbox.response.200.connection`; object, required)
  - `id` (`post-test-provider-connect-sandbox.response.200.connection.id`; string, required)
  - `object` (`post-test-provider-connect-sandbox.response.200.connection.object`; string, required)
  - `provider` (`post-test-provider-connect-sandbox.response.200.connection.provider`; string, required)
    - one of `"simulator"`, `"bizlinks"`
  - `mode` (`post-test-provider-connect-sandbox.response.200.connection.mode`; string, required) — `simulator`: never reaches SUNAT · `sandbox`: the provider's test environment · `production`: real invoices.
    - one of `"simulator"`, `"sandbox"`, `"production"`
  - `status` (`post-test-provider-connect-sandbox.response.200.connection.status`; string, required)
    - one of `"active"`, `"disabled"`
  - `series` (`post-test-provider-connect-sandbox.response.200.connection.series`; array<string>, required) — The series this connection serves: an invoice of one of them goes out through this provider.
  - `account` (`post-test-provider-connect-sandbox.response.200.connection.account`; object, required)
    - `status` (`post-test-provider-connect-sandbox.response.200.connection.account.status`; string, required)
      - one of `"ok"`, `"blocked"`
    - `scope` (`post-test-provider-connect-sandbox.response.200.connection.account.scope`; string, required) — `platform`: the account is the service's own and is fixed by its staff. `connection`: it belongs to this organization.
      - one of `"platform"`, `"connection"`
    - `code` (`post-test-provider-connect-sandbox.response.200.connection.account.code`; any of, required) — A stable code while blocked. Never the provider's text. New values may appear: treat an unknown one as a blocked account.
      - any of: `string`, `null`
    - `since` (`post-test-provider-connect-sandbox.response.200.connection.account.since`; string | null, required)
    - `summary` (`post-test-provider-connect-sandbox.response.200.connection.account.summary`; string | null, required)
  - `created_at` (`post-test-provider-connect-sandbox.response.200.connection.created_at`; string, required)
- `series` (`post-test-provider-connect-sandbox.response.200.series`; array<object>, required)
  - `id` (`post-test-provider-connect-sandbox.response.200.series.id`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.200.series.code`; string, required)
  - `document_type` (`post-test-provider-connect-sandbox.response.200.series.document_type`; string, required)
    - one of `"factura"`, `"boleta"`
  - `establishment` (`post-test-provider-connect-sandbox.response.200.series.establishment`; string, required) — The SUNAT annex code of the establishment the series belongs to (II-D226).
  - `last_number` (`post-test-provider-connect-sandbox.response.200.series.last_number`; integer, required) — The counter: the next number minus one; after an adjustment it may never have been issued. The number that really went out is `last_issued.number`.
    - min -9007199254740991; max 9007199254740991
  - `next_number` (`post-test-provider-connect-sandbox.response.200.series.next_number`; integer, required) — The number the next invoice of this series takes.
    - min -9007199254740991; max 9007199254740991
  - `last_issued` (`post-test-provider-connect-sandbox.response.200.series.last_issued`; any of, required) — The last number that really went out: the invoice with the highest number of this series in ANY state (accepted, rejected, still on its way or held), because every one of them consumed its number. An adjustment of `next_number` does not change it. `null`: no invoice has taken a number of this series yet.
    - any of:
      - `object`
        - `number` (`post-test-provider-connect-sandbox.response.200.series.last_issued.1.number`; integer, required) — The highest number an invoice of this series holds.
          - min -9007199254740991; max 9007199254740991
        - `invoice_id` (`post-test-provider-connect-sandbox.response.200.series.last_issued.1.invoice_id`; string, required) — The invoice that holds it: GET /v1/invoices/{id}.
        - `status` (`post-test-provider-connect-sandbox.response.200.series.last_issued.1.status`; string, required) — Its public status, the same words as the listing (`processing`, `accepted`, `rejected`, `failed`, `voided`).
          - one of `"processing"`, `"accepted"`, `"rejected"`, `"failed"`, `"voided"`
        - `issued_at` (`post-test-provider-connect-sandbox.response.200.series.last_issued.1.issued_at`; string, required) — Its issue date: Lima's wall clock, `YYYY-MM-DDTHH:mm:ss`, without a zone (as `issue_date` of the invoice).
      - `null`
  - `status` (`post-test-provider-connect-sandbox.response.200.series.status`; string, required)
  - `created_at` (`post-test-provider-connect-sandbox.response.200.series.created_at`; string, required)
- `what_next` (`post-test-provider-connect-sandbox.response.200.what_next`; string, required)

### 201

The sandbox connection and its series.

#### Example

```json
{
  "object": "sandbox_connection",
  "connection": {
    "id": "string",
    "object": "provider_connection",
    "provider": "simulator",
    "mode": "simulator",
    "status": "active",
    "series": [
      "string"
    ],
    "account": {
      "status": "ok",
      "scope": "platform",
      "code": "provider_account_suspended",
      "since": "string",
      "summary": "string"
    },
    "created_at": "string"
  },
  "series": [
    {
      "id": "string",
      "code": "string",
      "document_type": "factura",
      "establishment": "string",
      "last_number": -9007199254740991,
      "next_number": -9007199254740991,
      "last_issued": {
        "number": -9007199254740991,
        "invoice_id": "string",
        "status": "processing",
        "issued_at": "string"
      },
      "status": "string",
      "created_at": "string"
    }
  ],
  "what_next": "string"
}
```

- `object` (`post-test-provider-connect-sandbox.response.201.object`; string, required)
- `connection` (`post-test-provider-connect-sandbox.response.201.connection`; object, required)
  - `id` (`post-test-provider-connect-sandbox.response.201.connection.id`; string, required)
  - `object` (`post-test-provider-connect-sandbox.response.201.connection.object`; string, required)
  - `provider` (`post-test-provider-connect-sandbox.response.201.connection.provider`; string, required)
    - one of `"simulator"`, `"bizlinks"`
  - `mode` (`post-test-provider-connect-sandbox.response.201.connection.mode`; string, required) — `simulator`: never reaches SUNAT · `sandbox`: the provider's test environment · `production`: real invoices.
    - one of `"simulator"`, `"sandbox"`, `"production"`
  - `status` (`post-test-provider-connect-sandbox.response.201.connection.status`; string, required)
    - one of `"active"`, `"disabled"`
  - `series` (`post-test-provider-connect-sandbox.response.201.connection.series`; array<string>, required) — The series this connection serves: an invoice of one of them goes out through this provider.
  - `account` (`post-test-provider-connect-sandbox.response.201.connection.account`; object, required)
    - `status` (`post-test-provider-connect-sandbox.response.201.connection.account.status`; string, required)
      - one of `"ok"`, `"blocked"`
    - `scope` (`post-test-provider-connect-sandbox.response.201.connection.account.scope`; string, required) — `platform`: the account is the service's own and is fixed by its staff. `connection`: it belongs to this organization.
      - one of `"platform"`, `"connection"`
    - `code` (`post-test-provider-connect-sandbox.response.201.connection.account.code`; any of, required) — A stable code while blocked. Never the provider's text. New values may appear: treat an unknown one as a blocked account.
      - any of: `string`, `null`
    - `since` (`post-test-provider-connect-sandbox.response.201.connection.account.since`; string | null, required)
    - `summary` (`post-test-provider-connect-sandbox.response.201.connection.account.summary`; string | null, required)
  - `created_at` (`post-test-provider-connect-sandbox.response.201.connection.created_at`; string, required)
- `series` (`post-test-provider-connect-sandbox.response.201.series`; array<object>, required)
  - `id` (`post-test-provider-connect-sandbox.response.201.series.id`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.201.series.code`; string, required)
  - `document_type` (`post-test-provider-connect-sandbox.response.201.series.document_type`; string, required)
    - one of `"factura"`, `"boleta"`
  - `establishment` (`post-test-provider-connect-sandbox.response.201.series.establishment`; string, required) — The SUNAT annex code of the establishment the series belongs to (II-D226).
  - `last_number` (`post-test-provider-connect-sandbox.response.201.series.last_number`; integer, required) — The counter: the next number minus one; after an adjustment it may never have been issued. The number that really went out is `last_issued.number`.
    - min -9007199254740991; max 9007199254740991
  - `next_number` (`post-test-provider-connect-sandbox.response.201.series.next_number`; integer, required) — The number the next invoice of this series takes.
    - min -9007199254740991; max 9007199254740991
  - `last_issued` (`post-test-provider-connect-sandbox.response.201.series.last_issued`; any of, required) — The last number that really went out: the invoice with the highest number of this series in ANY state (accepted, rejected, still on its way or held), because every one of them consumed its number. An adjustment of `next_number` does not change it. `null`: no invoice has taken a number of this series yet.
    - any of:
      - `object`
        - `number` (`post-test-provider-connect-sandbox.response.201.series.last_issued.1.number`; integer, required) — The highest number an invoice of this series holds.
          - min -9007199254740991; max 9007199254740991
        - `invoice_id` (`post-test-provider-connect-sandbox.response.201.series.last_issued.1.invoice_id`; string, required) — The invoice that holds it: GET /v1/invoices/{id}.
        - `status` (`post-test-provider-connect-sandbox.response.201.series.last_issued.1.status`; string, required) — Its public status, the same words as the listing (`processing`, `accepted`, `rejected`, `failed`, `voided`).
          - one of `"processing"`, `"accepted"`, `"rejected"`, `"failed"`, `"voided"`
        - `issued_at` (`post-test-provider-connect-sandbox.response.201.series.last_issued.1.issued_at`; string, required) — Its issue date: Lima's wall clock, `YYYY-MM-DDTHH:mm:ss`, without a zone (as `issue_date` of the invoice).
      - `null`
  - `status` (`post-test-provider-connect-sandbox.response.201.series.status`; string, required)
  - `created_at` (`post-test-provider-connect-sandbox.response.201.series.created_at`; string, required)
- `what_next` (`post-test-provider-connect-sandbox.response.201.what_next`; string, required)

### 400

`organization_required`: This credential needs to say which organization it acts on · `validation_failed`: The request is not valid · `malformed_request`: The request body is not valid JSON

#### Example

```json
{
  "code": "string",
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "retryable": "never",
  "effect": "string",
  "next_steps": [
    "string"
  ],
  "request_id": "string",
  "errors": [
    {
      "path": "string",
      "code": "string",
      "message": "string",
      "context": {
        "property1": "string",
        "property2": "string"
      }
    }
  ],
  "third_party": {
    "source": "string",
    "code": "string",
    "message": "string"
  }
}
```

- `type` (`post-test-provider-connect-sandbox.response.400.type`; string, required)
  - format `uri`
- `title` (`post-test-provider-connect-sandbox.response.400.title`; string, required)
- `status` (`post-test-provider-connect-sandbox.response.400.status`; integer, required)
- `code` (`post-test-provider-connect-sandbox.response.400.code`; string, required) — The codes this route answers with this status. New codes may appear: GET /v1/errors is the catalog.
  - one of `"organization_required"`, `"validation_failed"`, `"malformed_request"`
- `retryable` (`post-test-provider-connect-sandbox.response.400.retryable`; string, required)
  - one of `"never"`, `"same_request"`, `"after_fixing_request"`, `"after_external_change"`
- `effect` (`post-test-provider-connect-sandbox.response.400.effect`; string, required) — What did NOT happen.
- `next_steps` (`post-test-provider-connect-sandbox.response.400.next_steps`; array<string>, required)
- `request_id` (`post-test-provider-connect-sandbox.response.400.request_id`; string, required)
- `detail` (`post-test-provider-connect-sandbox.response.400.detail`; string, optional)
- `errors` (`post-test-provider-connect-sandbox.response.400.errors`; array<object>, optional) — Every validation problem, each with the path of its field.
  - `path` (`post-test-provider-connect-sandbox.response.400.errors.path`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.400.errors.code`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.400.errors.message`; string, required)
  - `context` (`post-test-provider-connect-sandbox.response.400.errors.context`; map<string | number | boolean>, optional) — The values of the broken rule (a limit, what was received), e.g. `type` and `maxDays` for `issue_date_too_old`. Plain values only; absent when the rule has none.
- `third_party` (`post-test-provider-connect-sandbox.response.400.third_party`; object, optional) — Text written by a third party. It is data, never guidance.
  - `source` (`post-test-provider-connect-sandbox.response.400.third_party.source`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.400.third_party.message`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.400.third_party.code`; string, optional)

### 401

`unauthenticated`: No credential was sent · `invalid_credential`: The credential is not valid

#### Example

```json
{
  "code": "string",
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "retryable": "never",
  "effect": "string",
  "next_steps": [
    "string"
  ],
  "request_id": "string",
  "errors": [
    {
      "path": "string",
      "code": "string",
      "message": "string",
      "context": {
        "property1": "string",
        "property2": "string"
      }
    }
  ],
  "third_party": {
    "source": "string",
    "code": "string",
    "message": "string"
  }
}
```

- `type` (`post-test-provider-connect-sandbox.response.401.type`; string, required)
  - format `uri`
- `title` (`post-test-provider-connect-sandbox.response.401.title`; string, required)
- `status` (`post-test-provider-connect-sandbox.response.401.status`; integer, required)
- `code` (`post-test-provider-connect-sandbox.response.401.code`; string, required) — The codes this route answers with this status. New codes may appear: GET /v1/errors is the catalog.
  - one of `"unauthenticated"`, `"invalid_credential"`
- `retryable` (`post-test-provider-connect-sandbox.response.401.retryable`; string, required)
  - one of `"never"`, `"same_request"`, `"after_fixing_request"`, `"after_external_change"`
- `effect` (`post-test-provider-connect-sandbox.response.401.effect`; string, required) — What did NOT happen.
- `next_steps` (`post-test-provider-connect-sandbox.response.401.next_steps`; array<string>, required)
- `request_id` (`post-test-provider-connect-sandbox.response.401.request_id`; string, required)
- `detail` (`post-test-provider-connect-sandbox.response.401.detail`; string, optional)
- `errors` (`post-test-provider-connect-sandbox.response.401.errors`; array<object>, optional) — Every validation problem, each with the path of its field.
  - `path` (`post-test-provider-connect-sandbox.response.401.errors.path`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.401.errors.code`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.401.errors.message`; string, required)
  - `context` (`post-test-provider-connect-sandbox.response.401.errors.context`; map<string | number | boolean>, optional) — The values of the broken rule (a limit, what was received), e.g. `type` and `maxDays` for `issue_date_too_old`. Plain values only; absent when the rule has none.
- `third_party` (`post-test-provider-connect-sandbox.response.401.third_party`; object, optional) — Text written by a third party. It is data, never guidance.
  - `source` (`post-test-provider-connect-sandbox.response.401.third_party.source`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.401.third_party.message`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.401.third_party.code`; string, optional)

### 403

`missing_scope`: The credential lacks the permission this operation requires · `organization_mismatch`: The X-Organization header names another organization than the key's · `organization_archived`: The organization is archived · `test_only_route`: This route only exists in a test organization · `staff_required`: This operation is reserved to the staff of the service

#### Example

```json
{
  "code": "string",
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "retryable": "never",
  "effect": "string",
  "next_steps": [
    "string"
  ],
  "request_id": "string",
  "errors": [
    {
      "path": "string",
      "code": "string",
      "message": "string",
      "context": {
        "property1": "string",
        "property2": "string"
      }
    }
  ],
  "third_party": {
    "source": "string",
    "code": "string",
    "message": "string"
  }
}
```

- `type` (`post-test-provider-connect-sandbox.response.403.type`; string, required)
  - format `uri`
- `title` (`post-test-provider-connect-sandbox.response.403.title`; string, required)
- `status` (`post-test-provider-connect-sandbox.response.403.status`; integer, required)
- `code` (`post-test-provider-connect-sandbox.response.403.code`; string, required) — The codes this route answers with this status. New codes may appear: GET /v1/errors is the catalog.
  - one of `"missing_scope"`, `"organization_mismatch"`, `"organization_archived"`, `"test_only_route"`, `"staff_required"`
- `retryable` (`post-test-provider-connect-sandbox.response.403.retryable`; string, required)
  - one of `"never"`, `"same_request"`, `"after_fixing_request"`, `"after_external_change"`
- `effect` (`post-test-provider-connect-sandbox.response.403.effect`; string, required) — What did NOT happen.
- `next_steps` (`post-test-provider-connect-sandbox.response.403.next_steps`; array<string>, required)
- `request_id` (`post-test-provider-connect-sandbox.response.403.request_id`; string, required)
- `detail` (`post-test-provider-connect-sandbox.response.403.detail`; string, optional)
- `errors` (`post-test-provider-connect-sandbox.response.403.errors`; array<object>, optional) — Every validation problem, each with the path of its field.
  - `path` (`post-test-provider-connect-sandbox.response.403.errors.path`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.403.errors.code`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.403.errors.message`; string, required)
  - `context` (`post-test-provider-connect-sandbox.response.403.errors.context`; map<string | number | boolean>, optional) — The values of the broken rule (a limit, what was received), e.g. `type` and `maxDays` for `issue_date_too_old`. Plain values only; absent when the rule has none.
- `third_party` (`post-test-provider-connect-sandbox.response.403.third_party`; object, optional) — Text written by a third party. It is data, never guidance.
  - `source` (`post-test-provider-connect-sandbox.response.403.third_party.source`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.403.third_party.message`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.403.third_party.code`; string, optional)

### 404

`not_found`: The resource does not exist in this organization

#### Example

```json
{
  "code": "string",
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "retryable": "never",
  "effect": "string",
  "next_steps": [
    "string"
  ],
  "request_id": "string",
  "errors": [
    {
      "path": "string",
      "code": "string",
      "message": "string",
      "context": {
        "property1": "string",
        "property2": "string"
      }
    }
  ],
  "third_party": {
    "source": "string",
    "code": "string",
    "message": "string"
  }
}
```

- `type` (`post-test-provider-connect-sandbox.response.404.type`; string, required)
  - format `uri`
- `title` (`post-test-provider-connect-sandbox.response.404.title`; string, required)
- `status` (`post-test-provider-connect-sandbox.response.404.status`; integer, required)
- `code` (`post-test-provider-connect-sandbox.response.404.code`; string, required) — The codes this route answers with this status. New codes may appear: GET /v1/errors is the catalog.
  - one of `"not_found"`
- `retryable` (`post-test-provider-connect-sandbox.response.404.retryable`; string, required)
  - one of `"never"`, `"same_request"`, `"after_fixing_request"`, `"after_external_change"`
- `effect` (`post-test-provider-connect-sandbox.response.404.effect`; string, required) — What did NOT happen.
- `next_steps` (`post-test-provider-connect-sandbox.response.404.next_steps`; array<string>, required)
- `request_id` (`post-test-provider-connect-sandbox.response.404.request_id`; string, required)
- `detail` (`post-test-provider-connect-sandbox.response.404.detail`; string, optional)
- `errors` (`post-test-provider-connect-sandbox.response.404.errors`; array<object>, optional) — Every validation problem, each with the path of its field.
  - `path` (`post-test-provider-connect-sandbox.response.404.errors.path`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.404.errors.code`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.404.errors.message`; string, required)
  - `context` (`post-test-provider-connect-sandbox.response.404.errors.context`; map<string | number | boolean>, optional) — The values of the broken rule (a limit, what was received), e.g. `type` and `maxDays` for `issue_date_too_old`. Plain values only; absent when the rule has none.
- `third_party` (`post-test-provider-connect-sandbox.response.404.third_party`; object, optional) — Text written by a third party. It is data, never guidance.
  - `source` (`post-test-provider-connect-sandbox.response.404.third_party.source`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.404.third_party.message`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.404.third_party.code`; string, optional)

### 409

`issuer_not_configured`: The organization has no issuer yet · `series_already_exists`: A series with this code already exists

#### Example

```json
{
  "code": "string",
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "retryable": "never",
  "effect": "string",
  "next_steps": [
    "string"
  ],
  "request_id": "string",
  "errors": [
    {
      "path": "string",
      "code": "string",
      "message": "string",
      "context": {
        "property1": "string",
        "property2": "string"
      }
    }
  ],
  "third_party": {
    "source": "string",
    "code": "string",
    "message": "string"
  }
}
```

- `type` (`post-test-provider-connect-sandbox.response.409.type`; string, required)
  - format `uri`
- `title` (`post-test-provider-connect-sandbox.response.409.title`; string, required)
- `status` (`post-test-provider-connect-sandbox.response.409.status`; integer, required)
- `code` (`post-test-provider-connect-sandbox.response.409.code`; string, required) — The codes this route answers with this status. New codes may appear: GET /v1/errors is the catalog.
  - one of `"issuer_not_configured"`, `"series_already_exists"`
- `retryable` (`post-test-provider-connect-sandbox.response.409.retryable`; string, required)
  - one of `"never"`, `"same_request"`, `"after_fixing_request"`, `"after_external_change"`
- `effect` (`post-test-provider-connect-sandbox.response.409.effect`; string, required) — What did NOT happen.
- `next_steps` (`post-test-provider-connect-sandbox.response.409.next_steps`; array<string>, required)
- `request_id` (`post-test-provider-connect-sandbox.response.409.request_id`; string, required)
- `detail` (`post-test-provider-connect-sandbox.response.409.detail`; string, optional)
- `errors` (`post-test-provider-connect-sandbox.response.409.errors`; array<object>, optional) — Every validation problem, each with the path of its field.
  - `path` (`post-test-provider-connect-sandbox.response.409.errors.path`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.409.errors.code`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.409.errors.message`; string, required)
  - `context` (`post-test-provider-connect-sandbox.response.409.errors.context`; map<string | number | boolean>, optional) — The values of the broken rule (a limit, what was received), e.g. `type` and `maxDays` for `issue_date_too_old`. Plain values only; absent when the rule has none.
- `third_party` (`post-test-provider-connect-sandbox.response.409.third_party`; object, optional) — Text written by a third party. It is data, never guidance.
  - `source` (`post-test-provider-connect-sandbox.response.409.third_party.source`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.409.third_party.message`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.409.third_party.code`; string, optional)

### 429

`rate_limited`: Too many requests

#### Example

```json
{
  "code": "string",
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "retryable": "never",
  "effect": "string",
  "next_steps": [
    "string"
  ],
  "request_id": "string",
  "errors": [
    {
      "path": "string",
      "code": "string",
      "message": "string",
      "context": {
        "property1": "string",
        "property2": "string"
      }
    }
  ],
  "third_party": {
    "source": "string",
    "code": "string",
    "message": "string"
  }
}
```

- `type` (`post-test-provider-connect-sandbox.response.429.type`; string, required)
  - format `uri`
- `title` (`post-test-provider-connect-sandbox.response.429.title`; string, required)
- `status` (`post-test-provider-connect-sandbox.response.429.status`; integer, required)
- `code` (`post-test-provider-connect-sandbox.response.429.code`; string, required) — The codes this route answers with this status. New codes may appear: GET /v1/errors is the catalog.
  - one of `"rate_limited"`
- `retryable` (`post-test-provider-connect-sandbox.response.429.retryable`; string, required)
  - one of `"never"`, `"same_request"`, `"after_fixing_request"`, `"after_external_change"`
- `effect` (`post-test-provider-connect-sandbox.response.429.effect`; string, required) — What did NOT happen.
- `next_steps` (`post-test-provider-connect-sandbox.response.429.next_steps`; array<string>, required)
- `request_id` (`post-test-provider-connect-sandbox.response.429.request_id`; string, required)
- `detail` (`post-test-provider-connect-sandbox.response.429.detail`; string, optional)
- `errors` (`post-test-provider-connect-sandbox.response.429.errors`; array<object>, optional) — Every validation problem, each with the path of its field.
  - `path` (`post-test-provider-connect-sandbox.response.429.errors.path`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.429.errors.code`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.429.errors.message`; string, required)
  - `context` (`post-test-provider-connect-sandbox.response.429.errors.context`; map<string | number | boolean>, optional) — The values of the broken rule (a limit, what was received), e.g. `type` and `maxDays` for `issue_date_too_old`. Plain values only; absent when the rule has none.
- `third_party` (`post-test-provider-connect-sandbox.response.429.third_party`; object, optional) — Text written by a third party. It is data, never guidance.
  - `source` (`post-test-provider-connect-sandbox.response.429.third_party.source`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.429.third_party.message`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.429.third_party.code`; string, optional)

### 500

`internal_error`: The service failed

#### Example

```json
{
  "code": "string",
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "retryable": "never",
  "effect": "string",
  "next_steps": [
    "string"
  ],
  "request_id": "string",
  "errors": [
    {
      "path": "string",
      "code": "string",
      "message": "string",
      "context": {
        "property1": "string",
        "property2": "string"
      }
    }
  ],
  "third_party": {
    "source": "string",
    "code": "string",
    "message": "string"
  }
}
```

- `type` (`post-test-provider-connect-sandbox.response.500.type`; string, required)
  - format `uri`
- `title` (`post-test-provider-connect-sandbox.response.500.title`; string, required)
- `status` (`post-test-provider-connect-sandbox.response.500.status`; integer, required)
- `code` (`post-test-provider-connect-sandbox.response.500.code`; string, required) — The codes this route answers with this status. New codes may appear: GET /v1/errors is the catalog.
  - one of `"internal_error"`
- `retryable` (`post-test-provider-connect-sandbox.response.500.retryable`; string, required)
  - one of `"never"`, `"same_request"`, `"after_fixing_request"`, `"after_external_change"`
- `effect` (`post-test-provider-connect-sandbox.response.500.effect`; string, required) — What did NOT happen.
- `next_steps` (`post-test-provider-connect-sandbox.response.500.next_steps`; array<string>, required)
- `request_id` (`post-test-provider-connect-sandbox.response.500.request_id`; string, required)
- `detail` (`post-test-provider-connect-sandbox.response.500.detail`; string, optional)
- `errors` (`post-test-provider-connect-sandbox.response.500.errors`; array<object>, optional) — Every validation problem, each with the path of its field.
  - `path` (`post-test-provider-connect-sandbox.response.500.errors.path`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.500.errors.code`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.500.errors.message`; string, required)
  - `context` (`post-test-provider-connect-sandbox.response.500.errors.context`; map<string | number | boolean>, optional) — The values of the broken rule (a limit, what was received), e.g. `type` and `maxDays` for `issue_date_too_old`. Plain values only; absent when the rule has none.
- `third_party` (`post-test-provider-connect-sandbox.response.500.third_party`; object, optional) — Text written by a third party. It is data, never guidance.
  - `source` (`post-test-provider-connect-sandbox.response.500.third_party.source`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.500.third_party.message`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.500.third_party.code`; string, optional)

### 503

`service_unavailable`: The service cannot answer right now

#### Example

```json
{
  "code": "string",
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "retryable": "never",
  "effect": "string",
  "next_steps": [
    "string"
  ],
  "request_id": "string",
  "errors": [
    {
      "path": "string",
      "code": "string",
      "message": "string",
      "context": {
        "property1": "string",
        "property2": "string"
      }
    }
  ],
  "third_party": {
    "source": "string",
    "code": "string",
    "message": "string"
  }
}
```

- `type` (`post-test-provider-connect-sandbox.response.503.type`; string, required)
  - format `uri`
- `title` (`post-test-provider-connect-sandbox.response.503.title`; string, required)
- `status` (`post-test-provider-connect-sandbox.response.503.status`; integer, required)
- `code` (`post-test-provider-connect-sandbox.response.503.code`; string, required) — The codes this route answers with this status. New codes may appear: GET /v1/errors is the catalog.
  - one of `"service_unavailable"`
- `retryable` (`post-test-provider-connect-sandbox.response.503.retryable`; string, required)
  - one of `"never"`, `"same_request"`, `"after_fixing_request"`, `"after_external_change"`
- `effect` (`post-test-provider-connect-sandbox.response.503.effect`; string, required) — What did NOT happen.
- `next_steps` (`post-test-provider-connect-sandbox.response.503.next_steps`; array<string>, required)
- `request_id` (`post-test-provider-connect-sandbox.response.503.request_id`; string, required)
- `detail` (`post-test-provider-connect-sandbox.response.503.detail`; string, optional)
- `errors` (`post-test-provider-connect-sandbox.response.503.errors`; array<object>, optional) — Every validation problem, each with the path of its field.
  - `path` (`post-test-provider-connect-sandbox.response.503.errors.path`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.503.errors.code`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.503.errors.message`; string, required)
  - `context` (`post-test-provider-connect-sandbox.response.503.errors.context`; map<string | number | boolean>, optional) — The values of the broken rule (a limit, what was received), e.g. `type` and `maxDays` for `issue_date_too_old`. Plain values only; absent when the rule has none.
- `third_party` (`post-test-provider-connect-sandbox.response.503.third_party`; object, optional) — Text written by a third party. It is data, never guidance.
  - `source` (`post-test-provider-connect-sandbox.response.503.third_party.source`; string, required)
  - `message` (`post-test-provider-connect-sandbox.response.503.third_party.message`; string, required)
  - `code` (`post-test-provider-connect-sandbox.response.503.third_party.code`; string, optional)


Source: https://docs.invox.page/api/post-test-provider-connect-sandbox/index.md
