Spot - Orders

API Description

This API allows Spot customers to create and manage orders in the Tenaris Spot marketplace.

| Operation | Description | Specification |

| POST /spot/orders | Create a Spot order | POST |

| GET /spot/orders | Retrieve Spot orders | GET |

| GET /spot/orders/{id} | Retrieve a specific Spot order | GET |

Environments

Static mock:

URL https://customerapi-dev.azure-api.net/public/spot/orders

Sandbox:

URL https://customerapi-dev.azure-api.net/sb/spot/orders

Production:

URL https://customerapi-dev.azure-api.net/spot/orders

Create Spot Order

curl -X POST https://customerapi-dev.azure-api.net/sb/spot/orders \

-H "Authorization: Bearer {access_token}" \

-H "Content-Type: application/json" \

-d '{

"shipToParty": {"id": "SP-STP-001"},

"requestedDeliveryDate": "2024-06-01",

"items": [

{

"product": {"id": "SP-4521"},

"quantity": 100,

"uom": "ST"

}

]

}'

Response (201 Created):

{

"id": "MKP-ORD-001234",

"status": "PENDING_CONFIRMATION",

"createdDate": "2024-03-20T09:15:00Z"

}

Retrieve Spot Orders

curl -X GET "https://customerapi-dev.azure-api.net/sb/spot/orders?pageSize=10&pageNumber=1" \

-H "Authorization: Bearer {access_token}"

Response:

{

"page": {"pageSize": 10, "pageNumber": 1, "pageLimit": 1, "code": 200},

"results": [

{

"id": "MKP-ORD-001234",

"status": "CONFIRMED",

"shipToParty": {"id": "SP-STP-001", "description": "Houston Distribution Center"},

"items": [

{"product": {"id": "SP-4521", "description": "7\" 26.00# L80 BTC R3"}, "quantity": 100, "uom": "ST"}

],

"createdDate": "2024-03-20T09:15:00Z"

}

]

}

Spot-Specific Errors

| ERROR | DESCRIPTION |

| 400 | VALIDATION ERROR. Missing or invalid required fields. |

| 401 | ERROR IN TOKEN VALIDATION. |

| 403 | USER NOT AUTHORIZED. |

| 404 | ORDER NOT FOUND or PAGING PARAMETERS ERROR. |

| 409 | STOCK UNAVAILABLE. Requested quantity exceeds available stock. |

| 500 | GENERAL ERROR. |