V2
Schemas
Client
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| identity | Identity | true | Object representing the identity of a client |
| contact_phone | Phone | true | Phone object with prefix and phone number |
| name | string | false | Client name |
| surnames | [string] | false | Client surnames |
| string | false | Client email | |
| commercial_name | string | false | Client commercial name |
| address | Address | false | Address object with street, number, city, zip code, province and country |
Identity
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| document_id | string | true | Document Id |
| document_type | string | true | Document Type |
| Property | Values |
|---|---|
| document_type | one of [NIF, CIF, NIE, PASSPORT] |
Phone
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| phone_number | string | false | Phone Number |
| prefix | string | false | Phone prefix |
Address
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| street_type | string | false | Street type |
| street | string | true | Street name |
| number | string | false | Building number |
| additional_details | string | false | Other address parameters |
| city | string | true | City |
| zip_code | string | true | Postal code |
| province | string | true | Province |
| country | string | true | Country |
| bis | string | false | Bis |
| floor | string | false | Floor |
| block | string | false | Block |
| stair | string | false | Stair |
| letter | string | false | Letter |
Status
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | false | status id |
| value | StatusValue | false | status value |
| description | string | false | status description |
| final | boolean | false | Indicates if the status is a final state of an expedition |
| reshippable | boolean | false | Indicates if the status is reshippable in a new expedition, but not in this one |
| reason_code | string¦null | false | reason for the status, if needed |
| reason_description | string¦null | false | reason description, if needed |
| timestamp | string | false | status date |
Product
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| product_id | string | false | The product id in MasLogistics domain, usually suscription_device_id. (Read only parameter, only for GET requests) |
| product_code | string | true | Product code |
| product_description | string | false | Product description |
| product_type | string | false | The product type. (Read only parameter, only for GET requests) |
| product_type_id | integer | false | Product Type Id |
| product_unit_price | number | false | Product Unit price |
| icc_imei | string | false | product imei |
| identifier | string | false | The physical product identifier, usually SerialNumber/MAC/IMEI. (Read only parameter, only for GET requests) |
| quantity | integer | false | Product quantity |
| product_comments | string | false | Product comments |
| msisdn | string | false | MSISDN associated |
| financed | boolean | false | Is product financed |
| subscription_device_id | string | true | Identifier of an internal order in mas stack |
| remaining_payment | number | false | Remaining payment amount to pay on delivery |
| invoiced | boolean | false | If this value is false it indicates that the product is on lease if it is true it is on sale and we should have the data_invoice info. |
| status | AcceptanceStatus | false | The status of the product. (Read only parameter, only for GET requests) |
ProductWithExpedition
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | Product | false | Info about the product |
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | object | false | none |
| » associated_expedition | object | false | Associated expedition info |
| »» expedition_id | string | false | Unique expedition identifier |
| »» current_status | Status | false | Info about the status of the expedition |
ProductBasic
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| product_code | string | true | Product code |
| product_description | string | false | Product description |
| product_type | string | false | Product Type |
| product_type_id | integer | false | Product Type Id |
| identifier | string | false | Product imei/serial number. Mandatory for all the process types, except for routers unsubscription. |
| msisdn | string | false | MSISDN associated |
| subscription_device_id | string | true | Subscription device Id |
| Property | Values |
|---|---|
| product_type | one of [STB, TERMINAL, ROUTER] |
Pagination
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| page_size | integer | false | Page size |
| total_pages | integer | false | Total pages for page size |
| current_page | integer | false | Current page |
| total_elements | integer | false | Total element |
ArrayOfProductWithExpedition
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | Pagination | false | Pagination information |
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | object | false | List of products with expeditions |
| » products | [ProductWithExpedition] | false | Info about the product with the expedition |
Errors
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | [Error] | false | List of errors |
Error
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| title | string | false | Error description |
| ref | string | false | Link to error dictionary |
| details | string | false | Error detail message |
| code | string | false | Internal error code |
DataSales
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| agent | string | false | client reference |
| channel | DataSalesChannelEnum | false | Data sales channel |
| type | DataSalesTypeEnum | false | Data sales type |
| group | DataSalesGroupEnum | false | Data sales group |
DataDelivery
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| courier_id | CourierIdEnum | true | The courier identifier. For unknowns values, set to DEFAULT |
| delivery_service | DeliveryServiceIdEnum | true | Delivery service id. For unknowns values, set to DEFAULT |
| exclusive | boolean | true | Delivery to exact person |
| verify_identity | boolean | true | The carrier must verify the identity document |
| retrieve_contract | boolean | true | The carrier must return the signed document |
| group_by | string | false | Group by |
| secure_delivery | boolean | false | Defines if delivery should be secure |
| delivery_point_id | string | false | The delivery point identifier. Normally the store SFID. Mandatory for orders with delivery type SHOP. |
| delivery_shop_name | string | false | The delivery shop name. Mandatory for orders with delivery type SHOP. |
| return_code | string | false | The return code provided by the courier (Read only parameter, only for GET requests) |
| delivery_type | DeliveryTypeEnum | false | The delivery type |
| ol_comments | string | false | information or instructions for OL |
DeliveryTypeEnum
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | string | false | The delivery type |
| Property | Values |
|---|---|
| anonymous | one of [AGENCY, SHOP, HOME, COURIER] |
CourierIdEnum
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | string | false | The courier identifier. For unknowns values, set to DEFAULT |
| Property | Values |
|---|---|
| anonymous | one of [DEFAULT, GLS, HL, ASIGNA, SENDING, CORREOS, SUS_MEDIOS, INSIDE, ZELERIS, CTT] |
DeliveryServiceIdEnum
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | string | false | Delivery service id. For unknowns values, set to DEFAULT |
| Property | Values |
|---|---|
| anonymous | one of [DEFAULT, DELIVERY_24, DELIVERY_10AM, DELIVERY_14AM, DELIVERY_72, DELIVERY_SECURED, DELIVERY_INSTALL, DELIVERY_STANDARD] |
DataSalesChannelEnum
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | string | false | Data sales channel |
| Property | Values |
|---|---|
| anonymous | one of [TELE_SALE_CARE, EXCLUSIVE_POS, FRANCHISE_POS, INDIRECT_POS, SELF_SALE_CARE, D2D] |
DataSalesTypeEnum
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | string | false | Data sales type |
| Property | Values |
|---|---|
| anonymous | one of [NEW_SALE, ADD_SUBSCRIPTION_TO_BUNDLE, MIGRATION, EXISTENT_SUBSCRIPTION] |
DataSalesGroupEnum
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | string | false | Data sales group |
| Property | Values |
|---|---|
| anonymous | one of [POS, ONLINE_DISTRIBUTION, INBOUND, OUTBOUND, RETENTION, LOYALTY, UNSUBSCRIBE, CANCELLATIONS, UNDER_CUSTOMER_BASE, BROADCAST_CUSTOMER_BASE, ADMINISTRATOR, CUSTOMER_SUPPORT] |
StatusValue
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | string | false | status value |
| Property | Values |
|---|---|
| anonymous | one of [ABANDONED, ABSENT_INCIDENCE, ACCEPTED, ACCEPTED_BY_MANUFACTURER, CANCELLATION_REQUEST, CANCELLED, COLLECTED, COLLECTION_REQUEST, COMPLETE_RMA, CONTRACT_GENERATED, CONTRACT_MISSING, CONTRACT_NOT_RETRIEVED, CONTRACT_RETRIEVED, CONTRACT_SIGNED, CUSTOMER_CONTACTED, DELIVERED, DELIVERED_CUSTODIAN, DELIVERED_IN_DELIVERY_POINT, DELIVERED_TO_MANUFACTURER, DELIVERED_TO_OL, DELIVERY_IN_WAREHOUSE, DELIVERY_INCIDENCE, DELIVERY_REQUESTED, DELIVERY_TO_MANUFACTURER, DESTROYED, DISASTER, DOCUMENTATION_SENT, ERROR, ERROR_RMA, EXPEDITION_CREATED, EXPIRED, FAIL_CONTACT, FRAUD, IN_DELIVERY, IN_DELIVERY_TO_MANUFACTURER, IN_TRANSIT, IN_WAREHOUSE, INCIDENCE, MISSING_DATA, NOT_COLLECTED, NOT_DELIVERED, NOT_FRAUD, NOT_PENALIZED, NOT_PICKUP, NOT_SENT, ON_DEPARTURE, ORDER_MODIFIED, ORDER_READY, ORDER_RECEIVED, OUT_OF_STOCK, PAID, PENALIZED, PENDING_CUSTOMER_CONTACT, PENDING_PENALTY, PENDING_RMA, PERMANENCE_ALREADY_LOADED, PERMANENCE_ASSOCIATED, PICKING, PICKING_STARTED, PICKUP_ACORDED, PICKUP_DONE, PICKUP_FAIL, PICKUP_IN_PROCESS, PICKUP_MODIFIED, PICKUP_REQUEST, POSSIBLE_FRAUD, PREPICKING, READY_TO_SHIPPING, REFOUND_PENDING, REJECTED, REJECTED_BY_MANUFACTURER, RETURNED, RETURNED_TO_CLIENT, RETURNED_TO_OL, RETURNED_TO_WAREHOUSE, SENT, SENT_TO_MANUFACTURER, SENT_TO_OL, SENT_TO_WAREHOUSE, SINISTER, START_EXTRACTION, STARTED, STORED, STORED_IN_OL, TRANSPORT_INCIDENCE, UNKNOWN, WAREHOUSE_DELIVERED, WAREHOUSE_EXIT, WAREHOUSE_REJECTED] |
AcceptanceStatus
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | string | false | The status of the product. (Read only parameter, only for GET requests) |
| Property | Values |
|---|---|
| anonymous | one of [CREATED, DISCARDED] |
ReservationStatus
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| reservation_id | string | false | Reservation Id |
| order_id | string | false | Order Id (newOrder service) |
| status | string | true | Reservation status |
| zip_code | string | false | Postal code (Mandatory if the status is CONFIRM) |
| Property | Values |
|---|---|
| status | one of [CONFIRM, CANCEL] |
Reservation
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| data_sales | DataSales | false | Information related to sales associated with the order |
| product_id | string | true | Product identifier |
Order
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| order | NewOrderData | true | Main order data, including ID and essential details |
| data_sales | DataSales | false | Information related to sales associated with the order |
| client | Client | true | Object with client data |
| invoice | any | false | none |
| Name | Type | Required | Description |
|---|---|---|---|
| » anonymous | Invoice | false | Invoice information generated for the order |
| Name | Type | Required | Description |
|---|---|---|---|
| » anonymous | object | false | none |
| Name | Type | Required | Description |
|---|---|---|---|
| shipping | Shipping | true | Shipping details, including address and delivery info |
| products | [Product] | true | [Info about the product] |
| documentation | Documentation | false | Info about the documentation related to the order |
NewOrderData
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| reservation_id | string¦null | false | The reservation identifier |
| subscription_id | string | false | Identifier of a customer subscription, it can have several subscription_device_id associated to its line. |
| work_order | string | false | Work Order |
| order_id | string | false | The order identifier in MasLogistics domain. (Read only parameter, only for GET requests) |
| order_id_crm | string | false | The order identifier of the requester. For example, the ItemNumber. |
| business_process | DirectBusinessProcess | false | The business process |
| convergent | boolean | false | Is Order convergent |
| language | string | false | Order language |
| delivery_type | DeliveryTypeEnum | false | The delivery type |
| Property | Values |
|---|---|
| language | one of [ES, EN, EU, CA, GL, PT] |
DirectBusinessProcess
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | string | false | The business process |
| Property | Values |
|---|---|
| anonymous | one of [PEDIDO, BREAKDOWN_DELIVERY, MIGRATION_DELIVERY] |
CancellationRequest
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| cancellation_request_id | string | false | The identifier of the cancellation request in MasLogistics domain. (Read only parameter, only for GET requests) |
| reason | string | true | none |
| products | [ProductBasic] | true | [Info about the product] |
DeliveryConfirmationRequest
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| products | [ProductBasic] | false | [Info about the product] |
Document
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| document_id | string | false | Public document id managed by mas-logistics, not the id managed by mas-documents |
| document_type | string | false | Document Type |
| copies | integer | false | The number of copies that must be printed |
| signable | boolean | false | Defines if the document is signable in the MasLogistics context using the signOrderDocuments operation |
| signed | boolean | false | Defines if the document is signed. If the document is not signable, this field will never be true |
| Property | Values |
|---|---|
| document_type | one of [CONTRACT, INE, CCGG, DELIVERY_NOTE] |
DocumentWithUrl
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | Document | false | Object representing the document as contract, INE or delivery note |
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | object | false | none |
| » url | string | false | The public url to download the document |
ReservationCreateResponse
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| product_id | string | false | The product Id |
| reservation_id | string | false | Reservation Id |
| total_duration_in_seconds | number | false | The time in seconds that the reservation is available before expire. |
| valid_until | string | false | The timestamp when the reservation will expire in ISO 8601 format and UTC |
Invoice
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| address | Address | false | Address object with street, number, city, zip code, province and country |
| client | Client | false | Object with client data |
| data_invoice | DataInvoice | false | Data invoice information |
DataInvoice
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| base | number | true | base invoice |
| tax_value | number | true | invoice tax value |
| total_invoice | number | true | total invoice |
| discount | number | false | discount |
| payment_type | integer | true | payment type |
| residual_value | number | false | Final Payment |
| initial_payment | number | false | Initial payment |
| fee | Fee | false | Fee information |
Fee
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| amount | number | false | Fee amount |
| duration | integer | false | Fee duration |
Shipping
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| address | Address | true | Address object with street, number, city, zip code, province and country |
| contact_data | Client | true | Object with client data |
| data_delivery | DataDelivery | true | Data delivery information |
Documentation
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| letter_type | string | false | Letter type. Possible values: “H”, “T”, “TV”, “RW”, “SR”, “WF”, “WP”, “JN”, “JP”, “JR”, “LC”, “N”, “PP0”, “PP8”, “R” |
| documents | [Document] | false | List of documents |
SignDocumentsRequest
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| order_ids | [string] | false | Order ids to sign |
SignDocumentsResponse
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| sign_id | string | false | The sign id from MasDocuments |
| documents | [Document] | false | [Object representing the document as contract, INE or delivery note] |
ArrayOfOrders
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | Pagination | false | Pagination information |
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | object | false | List of Orders |
| » orders | [Order] | false | List of Orders |
ArrayOfDocuments
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | Pagination | false | Pagination information |
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | object | false | none |
| » documents | [Document] | false | [Object representing the document as contract, INE or delivery note] |
ArrayOfStockItem
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| data | [StockItem] | false | List of objects with stock information |
StockItem
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| warehouse_id | string | false | Warehouse Id |
| product_id | string | false | productId |
| available_quantity | integer | false | Available quantity |
PickupData
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| subscription_id | string | false | none |
| pickup_id | string | false | The pickup identifier in MasLogistics domain. (Read only parameter, only for GET requests) |
| order_id_external | string | false | The order identifier given by the logistics operator. (Read only parameter, only for GET requests) |
| order_id_crm | string | false | The order identifier of the request. It is mandatory to sent the OT in router unsubscription process. |
| language | string | false | Order language |
| business_process | ReverseBusinessProcess | true | The business process |
| reason | string | false | The reason of the pickup |
| delivery_type | DeliveryTypeEnum | true | The delivery type |
| access_reused | boolean | false | Access reused for routers pickups |
| Property | Values |
|---|---|
| language | one of [ES, EN, EU, CA, GL, PT] |
ReverseBusinessProcess
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | string | false | The business process |
| Property | Values |
|---|---|
| anonymous | one of [UNSUBSCRIPTION, WITHDRAWAL, CANCELLATION, FINALPAYMENT, BREAKDOWN_PICKUP, MIGRATION_PICKUP, CANCELLATION_SHOP] |
ShippingPickup
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| address | Address | true | Address object with street, number, city, zip code, province and country |
| contact_data | Client | true | Object with client data |
| transport_data | DataDelivery | true | Data delivery information |
Pickup
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| order | PickupData | true | none |
| data_sales | DataSales | false | Information related to sales associated with the order |
| client | Client | true | Object with client data |
| shipping | ShippingPickup | true | Shipping information for a pickup |
| products | [PickupProductBasic] | true | Info about the pickup Product |
PickupProductBasic
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | ProductBasic | false | Info about the product |
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | object | false | Basic information about a product in a pickup |
| » technology | string | false | Technology type for routers pickups |
| » status | AcceptanceStatus | false | The status of the product. (Read only parameter, only for GET requests) |
| Property | Values |
|---|---|
| technology | one of [FTTH, ADSL] |
ArrayOfPickups
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | Pagination | false | Pagination information |
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | object | false | List of Pickups |
| » pickups | [Pickup] | false | List of Pickups |
DataTransport
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| courier_id | CourierIdEnum | false | The courier identifier. For unknowns values, set to DEFAULT |
| delivery_service | DeliveryServiceIdEnum | false | Delivery service id. For unknowns values, set to DEFAULT |
| verify_identity | boolean | false | The carrier must verify the identity document |
Tracking
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| tracking_link | string¦null | false | tracking link for the delivery |
| return_code | string¦null | false | Code for returning the device |
Expedition
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| expedition_id | string | false | Expedition id |
| created_date | string | false | none |
| transport | DataTransport | false | none |
| tracking | Tracking | false | Info about the tracking of the order |
| status_history | [Status] | false | List of status |
| products | [Product] | false | List of products |
ArrayOfExpeditions
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | Pagination | false | Pagination information |
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | object | false | List of expeditions |
| » expeditions | [Expedition] | false | Info about the Expeditions |
ExternalOrder
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| order_id_external | string | true | External order identifier generated by the logistics operator (For example, the MasLola id). Must be constant for the same order |
| expedition_id_external | string | false | External expedition identifier generated by the logistics operator (For example, the EuroLogistics id). It may change during the order process |
| reexpedition | string | true | Reexpedition identifier |
| order_date | string | false | Order date in ISO 8601 format and UTC |
| logistics_operator | string | false | logistic operator |
| delivery_type | string | true | Delivery type. |
| process_type | string | false | Logistics process type. |
| logistic_operation | string | false | Logistic operation. |
| portability | boolean | false | order with associated portability |
| business | string | false | Business name |
| status | ExternalStatus | true | none |
| journeys | [Journey] | true | none |
| documentation_only | boolean | false | order with only documentation |
| documentation | ExternalDocumentation | false | none |
| customer_delivering_info | CustomerDeliveringInfo | false | Customer delivering information. Mandatory if the order is not present or if the customer delivering info has been changed from last status (Marked as updated). |
| Property | Values |
|---|---|
| logistics_operator | one of [INTERBOX, ANOVO, EUROLOGISTICA, DHL, CEX] |
| delivery_type | one of [HOME, AGENCY, SHOP, COURIER] |
| process_type | one of [SWAP, PEDIDO, BAJA, DESISTIMIENTO, CANCELACION, FIX, DOA, FINALPAYMENT, BREAKDOWN_DELIVERY, BREAKDOWN_PICKUP, MIGRATION_DELIVERY, MIGRATION_PICKUP, CANCELLATION_SHOP] |
| logistic_operation | one of [DELIVERY, PICKUP] |
Journey
|
|
ExternalDocumentation
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| preprinted | boolean | false | none |
| total_pages | number | false | Total printed pages |
| documents | [object] | false | none |
| » recipient | string | false | Recipient of the documentation |
| » document_type | string | false | Type of document |
| » quantity | number | false | Quantity of this document |
| Property | Values |
|---|---|
| recipient | one of [CLIENT, COMPANY] |
| document_type | one of [WL, INE, CONTRACT, INVOICE, SEPA, MIGRATION, PARTICULAR_CONDITIONS, FINANCING_CONDITIONS, PORTABILITY_VALIDATION] |
Transport
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| delivery_details | object | false | none |
| » package | object | false | none |
| »» weight | number | false | Weight in kg. |
| »» dimensions | number | false | Volume. |
| » coverage | boolean | false | Is covered by insurance |
| » secure_delivery | boolean | false | Defines if delivery should be secure |
| » remaining_payment | Price | false | none |
| » recipient_verification | object | false | none |
| »» exclusive_delivery | boolean | false | The carrier must verify the identity document |
| »» verification | object | false | none |
| »»» required | boolean | false | The carrier must take photo the identity document |
| »»» completed | boolean | false | The carrier successfully has taken photo the identity document |
| courier | string | true | Logistic transportation courier |
| service | string | true | Logistics Service type |
| tracking_link | string | false | Tracking link |
| expedition_number | string | false | The expedition number of the courier when its postal office |
| delivery_note | object | false | none |
| » delivery_note_id | string | false | Identificative number of the delivery note |
| » link | string | false | Link to the delivery note |
| Property | Values |
|---|---|
| courier | one of [GLS, HL, ASIGNA, SENDING, CORREOS, CORREOS_EXPRESS, INSIDE, SUS_MEDIOS, ZELERIS, CTT, MRW, PAACK, SEUR, UPS, DEFAULT] |
| service | one of [DELIVERY_24, DELIVERY_10AM, DELIVERY_14AM, DELIVERY_72, DELIVERY_SECURED, DELIVERY_INSTALL, DELIVERY_STANDARD, DEFAULT] |
BaseDevice
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| subscription | Subscription | false | none |
| type | DeviceType | false | none |
| reference | string | false | Device reference |
| replacement | string | false | replacement , posible values “Y” or “N” |
| identifier | string | false | Device’s identifier |
| additional_identifier | string | false | Additional identifier, if exists |
| active | boolean | false | The flag will be true if the device has been delivered and false if it has been collected |
| subscription_device_id | string | false | Subscription device Id |
| price | object | false | none |
| » markup | Price | false | none |
| » no_markup | Price | false | none |
Device
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| reference | string | true | Device reference |
| subscription | Subscription | true | none |
PickingDevice
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| subscription | Subscription | true | none |
DeviceType
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| action_id | string | false | Action id |
| family_id | string | false | Family code |
| id | string | false | Device type identifier. NULLABLE. |
| Property | Values |
|---|---|
| id | one of [SIM, TERMINAL, ROUTER, SMART_TV, SMARTHOME, STB, STB_APPLE, GENERIC, WIFIMESH] |
Subscription
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| subscription_id | string¦null | false | Subscription identifier |
| order_id | string | false | Order identifier |
| msisdn | string¦null | false | Mobile Station International Subscriber Directory Number. MSISDN associated for the order associated to the device. |
ExternalClient
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| identity | ExternalIdentity | true | none |
| contact_phone | ExternalPhone | true | none |
| name | string | false | Client name |
| surnames | [string] | false | none |
| string | false | Client email | |
| commercial_name | string | false | Client commercial name |
ExternalIdentity
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| document_id | string | true | Identity Document Id |
| document_type | string | true | Identity Document Type |
| Property | Values |
|---|---|
| document_type | one of [NIF, CIF, NIE, PASSPORT] |
Price
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| total | number | false | Total Amount |
| currency | string | false | Currency as ISO 4217 code |
ExternalPhone
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| phone_number | string | true | Phone Number |
| prefix | string | false | Phone prefix |
CustomerDeliveringInfo
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| address | ExternalAddress | false | none |
| client | ExternalClient | true | none |
| language | string | false | Preferred language as ISO 639-1 code |
| updated | boolean | false | Indicates if the customer delivery info has been changed from last status |
| Property | Values |
|---|---|
| language | one of [ES, CA, EU, EN, PT, GL] |
ExternalStatus
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | true | Status id |
| description | string | false | Description about status |
| timestamp | string | true | Order status timestamp in ISO 8601 format and UTC |
| reason | object | false | none |
| » code | string | false | The reason code of the status |
| » description | string | false | The reason description of the status |
ExternalAddress
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| building_street_type | string | false | Street type |
| building_street_name | string | false | Street name |
| building_number | string | false | Building number |
| building_floor | string | false | Building floor |
| building_others | string | false | Other address parameters |
| city | string | false | City |
| zipcode | string | false | Zip code |
| region | string | false | Region |
| country | string | false | Country ISO 3166 |
Obsolescence
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| reference | string | true | Unique reference identifier (primary key) |
| obsolete | boolean¦null | false | Whether the device is considered obsolete |
| breakdowns_maximum | integer(int32)¦null | false | Maximum number of breakdowns allowed before considering obsolete |
| days_obsolescence | integer(int32)¦null | false | Number of days since creation to mark as obsolete |
DeleteResponse
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| message | string | false | none |
| reference | string | false | none |
ArrayOfObsolescences
|
|
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | Pagination | false | Pagination information |
| Name | Type | Required | Description |
|---|---|---|---|
| anonymous | object | false | none |
| » obsolescences | [Obsolescence] | false | none |