# Drop Ship

## Introduction
The Drop Ship is used to communicate to the client once an order has been shipped or cancelled from OptiTurn, to close an order within the client's OMS.
### Post Confirmation:
The Drop Shipment Confirmation API is used to post a shipment confirmation for the orders shipped so that the client can close the order on their end. Optoro can POST a shipment confirmation to the client endpoint.
### Post Cancellation:
The Drop Shipment Cancellation API is used to post a cancelled order to a client endpoint. An order could be rejected or cancelled in the warehouse, due to the inventory not being found or it being damaged.
### Post Partial Cancellation:
The Drop Shipment Partial Cancellation API is used to post a partially cancelled order to a client endpoint. An order item could be cancelled in the warehouse, due to the inventory is not being found or damaged.
## Failure Handling
<p>When Optoro receives a 401 HTTP status, Optoro will request a new Authentication Token from the client's services and retry the request.</p> <p>When Optoro receives any other error (as described above and identified by a 4xx (not 401) or 5xx range http status code) Optoro will retry five times with the same message.  The retries will happen at an exponential backoff cadence in order not to overload machines.  If the failure persists, the message will be stored in a failure queue and Optoro will have a technical contact person reach out to client tech support to report a problem.  When the problem has been resolved, Optoro can manually retry failed requests.</p> <p>For Drop Shipment acknowledgement, all errors are handled the same since this is not in a user facing flow.  However, the differentiation of status codes will help Optoro when reporting an issue.</p>


Version: 1.0.0

## Servers

```
https://developer.optoro.com
```

## Download OpenAPI description

[Drop Ship](https://developer.optoro.com/_bundle/openapi/drop_ship/webhooks/openapi.yaml)

## Other

### POST a Drop Shipment Confirmation

 - [POST /drop_shipment_confirmation](https://developer.optoro.com/openapi/drop_ship/webhooks/openapi/other/drop_shipment_confirmation.md): Client endpoint to which Drop Shipment Confirmation data is posted to.
This endpoint along with any authentication mechanisms needed must be communicated to client's account manager.

### POST a Drop Shipment Cancellation

 - [POST /drop_shipment_cancellation](https://developer.optoro.com/openapi/drop_ship/webhooks/openapi/other/drop_shipment_cancellation.md): Client endpoint to which Drop Shipment Cancellation data is posted to.
This endpoint along with any authentication mechanisms needed must be communicated to client's account manager.

### POST a Drop Shipment Partial Cancellation

 - [POST /drop_shipment_partial_cancellation](https://developer.optoro.com/openapi/drop_ship/webhooks/openapi/other/drop_shipment_partial_cancellation.md): Client endpoint to which Drop Shipment Partial Cancellation data is posted to.
This endpoint along with any authentication mechanisms needed must be communicated to client's account manager.