Master Data

RIGS

API Description

This API allows the customer to list all the Rigs available with Tenaris. This API call retrieves information that will later be used on other API requests (for example, "Rig" is a mandatory field to be completed when creating an order).

| Operation | Description | Specification |

| GET /master-data/rigs | Retrieve all the rigs. | GET |

Environments

Static mock:

URL https://customerapi-dev.azure-api.net/public/master-data/rigs

Sandbox:

URL https://customerapi-dev.azure-api.net/sb/master-data/rigs

Production:

URL https://customerapi-dev.azure-api.net/master-data/rigs

Test this operation

curl -X GET https://customerapi-dev.azure-api.net/sb/master-data/rigs

Response:

{

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

"results": [

{"id": "268020", "description": "ADD-61"},

{"id": "268016", "description": "AD-134"},

{"id": "268019", "description": "AD-117"},

{"id": "268018", "description": "AD-114"}

]

}

WELLS

API Description

This API allows the customer to list all the Wells available with Tenaris. This API call retrieves information that will later be used on other API requests (for example, "Well" is a mandatory field to be completed when creating an order).

| Operation | Description | Specification |

| GET /master-data/wells | Retrieve all the wells. | GET |

Environments

Static mock:

URL https://customerapi-dev.azure-api.net/public/master-data/wells

Sandbox:

URL https://customerapi-dev.azure-api.net/sb/master-data/wells

Production:

URL https://customerapi-dev.azure-api.net/master-data/wells

Test this operation

curl -X GET https://customerapi-dev.azure-api.net/sb/master-data/wells?pageSize=10

Response:

{

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

"results": [

{"id": "14013", "description": "PGPAT2-20120000111."},

{"id": "14015", "description": "PGPAT2"},

{"id": "14014", "description": "BB233"}

]

}

SHIP TO PARTIES

API Description

This API allows the customer to get the Ship to Parties (locations) list available with Tenaris and select one to create an order.

| Operation | Description | Specification |

| GET /master-data/ship-to-parties | Retrieve all the Ship-to Parties | GET |

Environments

Static mock:

URL https://customerapi-dev.azure-api.net/public/master-data/ship-to-parties

Sandbox:

URL https://customerapi-dev.azure-api.net/sb/master-data/ship-to-parties

Production:

URL https://customerapi-dev.azure-api.net/master-data/ship-to-parties

Test this operation

curl -X GET https://customerapi-dev.azure-api.net/sb/master-data/ship-to-parties?pageSize=15

Response:

{

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

"results": [

{"id": "30004", "description": "0031027582 - TENARIS BAY CITY, INC."},

{"id": "17847", "description": "0030008151 - TENARIS GLOBAL SERVICES (U.S.A.) CO"},

{"id": "90", "description": "0009002842 - Thailand Ports"}

]

}

General Errors

| ERROR | DESCRIPTION |

| 401 | ERROR IN TOKEN VALIDATION. There is an issue with the token used in the request. |

| 403 | USER NOT AUTHORIZED. There is an error in the credentials. |

| 404 | PAGING PARAMETERS ERROR. Bad request. |

| 500 | GENERAL ERROR. Server side error. |