# API Vasp Expresso Parte 2
# Serviços
## Criar serviço
### Input
:::info
`POST /api/V3/Shipment/Service`
|Campo|Descrição|Tipo|Tamanho|Obrigatório|
|-|-|-|-|-|
|serviceTypeId|Código do tipo de serviço `(listagem fornecida abaixo)`|int||Sim|
|mustDeliverAtKiosStore|Serviço a ser entregue em Loja Kios|boolean||Não|
|kiosStoreCode|Código da Loja Kios|string|6|Não|
|serviceFlow|Característica do serviço `(Entrega = 0, PickAndReturn = 2)`|int||Sim|
|clientReference|Código de referencia do cliente|string|30|Não|
|clientBarCode|Código de barras do serviço|string|25|Não|
|pinCode|Código do pin|string|4|Não|
|numberOfVolumes|Número de volumes do serviço|int|200|Sim|
|totalWeightOfVolumes|Peso total do serviço|decimal|99999|Sim|
|amount|Valor a cobrar|decimal||Não|
|pod|Prova de entregua|boolean||Não|
|sms|Pretende enviar sms para cliente|boolean||Não|
|instructions|Instruções de envio|string|250|Não|
|deliveryDate|Data para entregua|datetime||Não|
|pickingDate|Data para recolha|datetime||Não|
|preferentialPeriodOfDelivery|Período preferencial de entrega `(ex.: 09:00-12:00 ou 09:00-12:00/14:00-18:00)`|string|23|Não|
|senderClientCode|Código do remetente|string|20|Não|
|senderName|Nome do remetente|string|100|Sim|
|senderContactName|Nome de contacto do remetente|string|200|Sim|
|senderContactPhoneNumber|Número de contacto do remetente|string|20|Não|
|senderContactEmail|E-mail de contacto do remetente|string|50|Não|
|senderAddressStreet|Morada do remetente|string|200|Sim|
|senderAddressDoorNumber|Número da porta do remetente|string|50|Não|
|senderAddressFloor|Número do andar do remetente|string|50|Não|
|senderAddressPlace|Local do remetente|string|100|Sim|
|senderAddressPostalCode|Código postal do remetente|string|10|Sim|
|senderAddressPostalCodePlace|Local postal do remetente|string|100|Sim|
|senderAddressCountryCode|Código do país do remetente `(ex.: PT ou ES)`|string|3|Sim|
|receiverClientCode|Código do destinatário|string|20|Não|
|receiverName|Nome do destinatário|string|100|Sim|
|receiverContactName|Nome de contacto do destinatário|string|200|Sim|
|receiverContactPhoneNumber|Número de contacto do destinatário|string|20|Não|
|receiverContactEmail|E-mail de contacto do destinatário|string|50|Não|
|receiverAddressStreet|Morada do destinatário|string|200|Sim|
|receiverAddressDoorNumber|Número da porta do destinatário|string|50|Não|
|receiverAddressFloor|Número do andar do destinatário|string|50|Não|
|receiverAddressPlace|Local do destinatário|string|100|Sim|
|receiverAddressPostalCode|Código postal do destinatário|string|10|Sim|
|receiverAddressPostalCodePlace|Local postal do destinatário|string|100|Sim|
|receiverAddressCountryCode|Código do país o destinatário (ex.: PT ou ES)|string|3|Sim|
|receiverFixedInstructions|Instruções fixas do serviço|string|250|Não|
|clientObservations1|Observações do cliente 1|string|50|Não|
|clientObservations2|Observações do cliente 2|string|50|Não|
|volumes|Volumes|Lista de volumes||Não|
Volume :
|Campo|Descrição|Tipo|Tamanho|Obrigatório|
|-|-|-|-|-|
| volumeBarCode | Código de barras do volue |string|30|Sim|
| volumeNumber | Número do volume |int||Sim|
| weight | Peso do volume |decimal||Sim|
TIpos de serviços :
| Código tipo de serviço|Descrição|
|-|-|
| 89 | Serviço de entrega de volumes |
| 90 | RECOLHA |
| 91 | TRANSFERÊNCIA |
| 92 | Serviço de entrega de paletes |
| 93 | VASP24 - Entrega volumes no dia seguinte |
| 94 | VASP10 - Entrega volumes até às dez horas do dia s |
| 95 | VASPWE - Entregas de volumes ao fim de semana |
| 96 | Entrega de volumes na rede Kios |
| 97 | VASPPAL - Entrega de paletes no dia seguinte |
| 99 | VMADAR - Entregas na Madeira por via aerea |
| 100 | VPSAAR - Entregas no Porto Santo via aerea |
| 101 | VACIAR - Entregas Açores I (S. Miguel) via aerea |
| 102 | VACIIAR - Entregas nos Açores II ( Restantes Ilhas |
| 103 | VDED - Serviço de entrega dedicada |
| 104 | VASPSAB - Entregas ao Sábado |
| 105 | VASPDOM - Entregas ao Domingo |
| 106 | VMADMAR - Entrega na Madeira via Maritima |
| 107 | VPSMAR - Entrega em Porto Santo via Marítima |
| 108 | VACIIMAR - Açores II ( restantes Ilhas) Via Maríti |
| 109 | VACIMAR - Ent. Açores I (S. Miguel) via Marítima |
| 110 | VVERDE - Recolha e Entrega Resíduos |
| 111 | VDAY - Entregas no mesmo Dia |
| 112 | VASP48 - Entrega volumes até 48 Horas |
| 113 | VASP13 - Entrega Dia seguinte até 13:00 Horas |
| 114 | VPALBASC- (Recolha Báscula) Entrega Palete Dia Seg |
| 115 | VB2CK-Particular-KIOS Entrega dia seguinte |
| 117 | VB2K-KIOS Entrega dia seguinte |
| 118 | VASP24DON - Recolha e Entrega DON |
| 119 | VASP48DOS - Recolha DON e Entrega DOS |
| 121 | VK2C24 - Recolha Kios Entrega Particular |
| 123 | VK2CIAR-Recolha Kios Entrega S. Miguel - Via Aérea |
| 124 | VK2CMAD - Recolha Kios Entrega Madeira Via Aérea |
| 125 | VKB2CDEV - Devoluções em Pontos Kios |
| 126 | VK2CINT - Recolha Kios Entrega Internacional |
| 127 | VDEV - Devoluções-Rec e Ent. no Expedidor |
| 128 | VK2C48 - Recolha Kios Entrega Particular |
| 129 | VVIST - Visita sugestão Encomenda |
| 130 | VKDEV - Devoluções KIOS |
| 131 | VTROCAS - Entrega e Recolha em Simultâneo |
| 132 | RVMADAR - Recolhas na Ilha da Madeira - Via aérea |
| 133 | VMADAR-SDIM - Entregas na SDIM - Madeira Aéreo |
| 134 | VASP05 - Entregas ás 05h |
| 135 | VASPPPROPET - Entrega "meias" paletes Propet |
| 137 | VASP24B2C - Entrega volumes B2C |
| 138 | SDIM24 - Entregas dentro do arquipélado no dia seg |
| 139 | SDIMAER - Entrega de volumes no continente |
| 140 | VRCIAR - Rec no Cont para ent nos Açores via aerea |
| 141 | VRCIMAR - Rec no Cont para ent nos Açores via mari |
| 142 | VMADCAR - Recolha na Madeira para entrega no Conti |
| 143 | VMADCMAR - Recolha na Madeira entrega no Continent |
| 144 | VACIICAR - Recolhas nos Açores II e entrega no Con |
| 145 | VACIICMAR - Recolhas nos Açores II e entrega no Co |
| 146 | VACICAR - Recolhas nos Açores I e entrega no Conti |
| 147 | VACICMAR - Recolha nos Açores I e entrega no Conti |
| 148 | Serviços de Logística |
| 149 | RECOLHA FIXA |
| 150 | RECOLHA 24 |
| 151 | Entrega no dia seguinte mailings |
| 152 | VASPPALSAB- Entrega de Paletes ao Sábado |
| 153 | Entregas Centralizadas de Paletes no Eixo Azambuja |
| 154 | VPALDEV - Serviço de devolução de paletes |
| 159 | VPALBASC - Entrega de paletes com báscula - Contin |
| 160 | VPALBASCA - Entrega de paletes c/ báscula e ajudan |
| 161 | VPALBASCH - Entrega de paletes c/ báscula e hora m |
| 162 | VB2KMA-Envios para KIOS - Madeira Aéreo |
| 163 | VB2KMM-Envios para KIOS - Madeira Marítimo |
| 164 | VB2KAA_1-Envios para KIOS - Açores Aéreo 1 |
| 165 | VB2KAM_1-Envios para KIOS - Açores Marítimo 1 |
| 166 | VB2KAA_2-Envios para KIOS - Açores Aéreo 2 |
| 167 | VB2KAM_2-Envios para KIOS - Açores Marítimo 2 |
| 175 | VASPPAL_MEIA - Entrega de meias paletes |
| 176 | VASPINT Envio Internacional |
| 177 | VNIGHT - Serviço de Entregas à noite |
| 178 | VPALAM - Entrega de paletes americanas |
| 179 | VPALMADMAR - Envio de Paletes para a Madeira Marít |
| 180 | VASPPALDOM - Entrega de Paletes ao Domingo |
| 181 | SDIM12 - Entregas dentro do arquipélago até 12h |
| 182 | SDIM Serviço dedicado |
| 183 | SDIM Serviço PHARMA |
| 184 | VPALW - Paletes Wurth |
:::
### Output
::: success
**OK : 200**
Resposta do pedido :
|Campo|Descrição|Tipo|
|-|-|-|
|service | Serviço criado | Service |
|description | Descrição do código http da operação `(ex.: OK)`| string |
|result | Número do código http da operação `(ex.: 200)` | string |
Service :
|Campo|Descrição|Tipo|
|-|-|-|
| serviceType | Descrição do tipo de serviço |ServiceType|
| kiosStore | Descrição do ponto de entrega (Loja Kios) |KiosStore|
| amount |Valor a cobrar|decimal|
| clientBarCode |Código de barras do serviço|string|
| clientReference |Código de referencia do cliente|string|
| deliveryDate |Data para entregua|datetime|
| pickingDate |Data para recolha|datetime|
| mustDeliverAtKiosStore |Serviço a ser entregue em Loja Kios|boolean|
| receiver | Descrição do destinatário | Receiver |
| receiverFixedInstructions |Instruções fixas do serviço|string|
| serviceFlow |Característica do serviço|int|
| sender | Descrição do remetente | Sender |
| volumes | Descrição dos volumes | Volumes |
| numberOfVolumes |Número de volumes do serviço|int|
ServiceType :
|Campo|Descrição|Tipo|
|-|-|-|
|serviceTypeId|Código do tipo de serviço |int|
|name|Nome do tipo de serviço |string|
|serviceType|Abreviação do tipo de serviço |string|
KiosStore :
|Campo|Descrição|Tipo|
|-|-|-|
|businessName|Nome de Loja Kios|string|
|businessPhone|Número de contacto|string|
|code|Código de Loja Kios|string|
|name|Nome do proprietário|string|
|address|Morada|string|
|postalCode|Código postal|string|
|postalCodePlace|Localidade postal|string|
|email|E-mail|string|
|municipality|Município|string|
|district|Distrito|string|
|longitude|Longitude|decimal|
|latitude|Latitude|decimal|
|weekSchedule|Horário da semana|string|
|saturdaySchedule|Horário de Sábado|string|
|sundaySchedule|Horário de Domingo|string|
|isOpenLocalHoliday|Aberto em feriados locais|boolean|
|isOpenNationalHoliday|Aberto em feriados nacionais|boolean|
|isOpenHolidayNextDay|Aberto no dia seguinte a feriado|boolean|
|isActive|Activo|boolean|
Sender :
|Campo|Descrição|Tipo|
|-|-|-|
|Code|Código do remetente|string|
|Name|Nome do remetente|string|
|Contact|Nome de contacto do remetente|string|
|Telephone|Número de contacto do remetente|string|
|ContactEmail|E-mail de contacto do remetente|string|
|Address|Morada do remetente|string|
|Place|Local do remetente|string|
|PostalCode|Código postal do remetente|string|
|PostalPlace|Local postal do remetente|string|
|Country|Código do país do remetente `(ex.: PT ou ES)`|string|
Receiver :
|Campo|Descrição|Tipo|
|-|-|-|
|Code|Código do remetente|string|
|Name|Nome do remetente|string|
|Contact|Nome de contacto do remetente|string|
|Telephone|Número de contacto do remetente|string|
|ContactEmail|E-mail de contacto do remetente|string|
|Address|Morada do remetente|string|
|Place|Local do remetente|string|
|PostalCode|Código postal do remetente|string|
|PostalPlace|Local postal do remetente|string|
|Country|Código do país do remetente `(ex.: PT ou ES)`|string|
Volume :
|Campo|Descrição|Tipo|
|-|-|-|
| volumeBarCode | Código de barras do volue |string|
| volumeNumber | Número do volume |int|
| weight | Peso do volume |decimal|
Erro :
|Campo|Descrição|Exemplo|
|-|-|-|
|message|Mensagem de erro|
|status|Status HTTP|400|
:::
:::warning
**Unauthorized : 401**
Token de autorização invalido ou expirado.
:::
### Código Exemplo
#### cURL
```curl=
curl --location --request POST 'https://vaspapirest.vaspexpresso.pt/api/V3/Shipment/Service' \
--header 'Authorization: Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE3NzYiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNDYzNzUxMSwiZXhwIjoxNjM0NzIzOTExLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.C9dDciSDGBjPPON8JkVUCQkIjZsmV93vAQYbhTS5wtg' \
--header 'Content-Type: application/json' \
--data-raw '{
"Service": {
"ServiceTypeId": 93,
"MustDeliverAtKiosStore": false,
"KiosStoreCode": null,
"ServiceFlow": 0,
"ClientReference": null,
"ClientBarCode": null,
"PinCode": null,
"NumberOfVolumes": 2,
"TotalWeightOfVolumes": 25,
"Amount": null,
"Pod": false,
"Sms": false,
"Instructions": null,
"DeliveryDate": null,
"PickingDate": null,
"PreferentialPeriodOfDelivery": null,
"SenderClientCode": null,
"SenderName": "Envio de testes",
"SenderContactName": "Envio de testes",
"SenderContactPhoneNumber": "960000000",
"SenderContactEmail": "testes@vasp.pt",
"SenderAddressStreet": "Rua Alto do Monte, nr 3",
"SenderAddressDoorNumber": null,
"SenderAddressFloor": null,
"SenderAddressPlace": "Lisboa",
"SenderAddressPostalCode": "1000-123",
"SenderAddressPostalCodePlace": "Lisboa",
"SenderAddressCountryCode": "PT",
"ReceiverClientCode": null,
"ReceiverName": "Recepção de testes",
"ReceiverContactName": "Recepção de testes",
"ReceiverContactPhoneNumber": "960000000",
"ReceiverContactEmail": null,
"ReceiverAddressStreet": "Av do Lago, nr 5",
"ReceiverAddressDoorNumber": null,
"ReceiverAddressFloor": null,
"ReceiverAddressPlace": "Porto",
"ReceiverAddressPostalCode": "4000-123",
"ReceiverAddressPostalCodePlace": "Porto",
"ReceiverAddressCountryCode": "PT",
"ReceiverFixedInstructions": null,
"Volumes": null,
"ClientObservations1": null,
"ClientObservations2": null,
}
}'
```
#### C#
```csharp=
var client = new RestClient("https://vaspapirest.vaspexpresso.pt/api/V3/Shipment/Service");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE3NzYiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNDYzNzUxMSwiZXhwIjoxNjM0NzIzOTExLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.C9dDciSDGBjPPON8JkVUCQkIjZsmV93vAQYbhTS5wtg");
request.AddHeader("Content-Type", "application/json");
var body = @"{
" + "\n" +
@" ""Service"": {
" + "\n" +
@" ""ServiceTypeId"": 93,
" + "\n" +
@" ""MustDeliverAtKiosStore"": false,
" + "\n" +
@" ""KiosStoreCode"": null,
" + "\n" +
@" ""ServiceFlow"": 0,
" + "\n" +
@" ""ClientReference"": null,
" + "\n" +
@" ""ClientBarCode"": null,
" + "\n" +
@" ""PinCode"": null,
" + "\n" +
@" ""NumberOfVolumes"": 2,
" + "\n" +
@" ""TotalWeightOfVolumes"": 25,
" + "\n" +
@" ""Amount"": null,
" + "\n" +
@" ""Pod"": false,
" + "\n" +
@" ""Sms"": false,
" + "\n" +
@" ""Instructions"": null,
" + "\n" +
@" ""DeliveryDate"": null,
" + "\n" +
@" ""PickingDate"": null,
" + "\n" +
@" ""PreferentialPeriodOfDelivery"": null,
" + "\n" +
@" ""SenderClientCode"": null,
" + "\n" +
@" ""SenderName"": ""Envio de testes"",
" + "\n" +
@" ""SenderContactName"": ""Envio de testes"",
" + "\n" +
@" ""SenderContactPhoneNumber"": ""960000000"",
" + "\n" +
@" ""SenderContactEmail"": ""testes@vasp.pt"",
" + "\n" +
@" ""SenderAddressStreet"": ""Rua Alto do Monte, nr 3"",
" + "\n" +
@" ""SenderAddressDoorNumber"": null,
" + "\n" +
@" ""SenderAddressFloor"": null,
" + "\n" +
@" ""SenderAddressPlace"": ""Lisboa"",
" + "\n" +
@" ""SenderAddressPostalCode"": ""1000-123"",
" + "\n" +
@" ""SenderAddressPostalCodePlace"": ""Lisboa"",
" + "\n" +
@" ""SenderAddressCountryCode"": ""PT"",
" + "\n" +
@" ""ReceiverClientCode"": null,
" + "\n" +
@" ""ReceiverName"": ""Recepção de testes"",
" + "\n" +
@" ""ReceiverContactName"": ""Recepção de testes"",
" + "\n" +
@" ""ReceiverContactPhoneNumber"": ""960000000"",
" + "\n" +
@" ""ReceiverContactEmail"": null,
" + "\n" +
@" ""ReceiverAddressStreet"": ""Av do Lago, nr 5"",
" + "\n" +
@" ""ReceiverAddressDoorNumber"": null,
" + "\n" +
@" ""ReceiverAddressFloor"": null,
" + "\n" +
@" ""ReceiverAddressPlace"": ""Porto"",
" + "\n" +
@" ""ReceiverAddressPostalCode"": ""4000-123"",
" + "\n" +
@" ""ReceiverAddressPostalCodePlace"": ""Porto"",
" + "\n" +
@" ""ReceiverAddressCountryCode"": ""PT"",
" + "\n" +
@" ""ReceiverFixedInstructions"": null,
" + "\n" +
@" ""Volumes"": null,
" + "\n" +
@" ""ClientObservations1"": null,
" + "\n" +
@" ""ClientObservations2"": null,
" + "\n" +
@" }
" + "\n" +
@"}";
request.AddParameter("application/json", body, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
```
#### Java
```java=
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://vaspapirest.vaspexpresso.pt/api/V3/Shipment/Service")
.header("Authorization", "Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE3NzYiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNDYzNzUxMSwiZXhwIjoxNjM0NzIzOTExLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.C9dDciSDGBjPPON8JkVUCQkIjZsmV93vAQYbhTS5wtg")
.header("Content-Type", "application/json")
.body("{\r\n \"Service\": {\r\n \"ServiceTypeId\": 93,\r\n \"MustDeliverAtKiosStore\": false,\r\n \"KiosStoreCode\": null,\r\n \"ServiceFlow\": 0,\r\n \"ClientReference\": null,\r\n \"ClientBarCode\": null,\r\n \"PinCode\": null,\r\n \"NumberOfVolumes\": 2,\r\n \"TotalWeightOfVolumes\": 25,\r\n \"Amount\": null,\r\n \"Pod\": false,\r\n \"Sms\": false,\r\n \"Instructions\": null,\r\n \"DeliveryDate\": null,\r\n \"PickingDate\": null,\r\n\t\"PreferentialPeriodOfDelivery\": null,\r\n \"SenderClientCode\": null,\r\n \"SenderName\": \"Envio de testes\",\r\n \"SenderContactName\": \"Envio de testes\",\r\n \"SenderContactPhoneNumber\": \"960000000\",\r\n \"SenderContactEmail\": \"testes@vasp.pt\",\r\n \"SenderAddressStreet\": \"Rua Alto do Monte, nr 3\",\r\n \"SenderAddressDoorNumber\": null,\r\n \"SenderAddressFloor\": null,\r\n \"SenderAddressPlace\": \"Lisboa\",\r\n \"SenderAddressPostalCode\": \"1000-123\",\r\n \"SenderAddressPostalCodePlace\": \"Lisboa\",\r\n \"SenderAddressCountryCode\": \"PT\",\r\n \"ReceiverClientCode\": null,\r\n \"ReceiverName\": \"Recepção de testes\",\r\n \"ReceiverContactName\": \"Recepção de testes\",\r\n \"ReceiverContactPhoneNumber\": \"960000000\",\r\n \"ReceiverContactEmail\": null,\r\n \"ReceiverAddressStreet\": \"Av do Lago, nr 5\",\r\n \"ReceiverAddressDoorNumber\": null,\r\n \"ReceiverAddressFloor\": null,\r\n \"ReceiverAddressPlace\": \"Porto\",\r\n \"ReceiverAddressPostalCode\": \"4000-123\",\r\n \"ReceiverAddressPostalCodePlace\": \"Porto\",\r\n \"ReceiverAddressCountryCode\": \"PT\",\r\n \"ReceiverFixedInstructions\": null,\r\n \"Volumes\": null,\r\n \"ClientObservations1\": null,\r\n \"ClientObservations2\": null,\r\n }\r\n}")
.asString();
```
#### Javascript
```javascript=
var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE3NzYiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNDYzNzUxMSwiZXhwIjoxNjM0NzIzOTExLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.C9dDciSDGBjPPON8JkVUCQkIjZsmV93vAQYbhTS5wtg");
myHeaders.append("Content-Type", "application/json");
var raw = "{\r\n \"Service\": {\r\n \"ServiceTypeId\": 93,\r\n \"MustDeliverAtKiosStore\": false,\r\n \"KiosStoreCode\": null,\r\n \"ServiceFlow\": 0,\r\n \"ClientReference\": null,\r\n \"ClientBarCode\": null,\r\n \"PinCode\": null,\r\n \"NumberOfVolumes\": 2,\r\n \"TotalWeightOfVolumes\": 25,\r\n \"Amount\": null,\r\n \"Pod\": false,\r\n \"Sms\": false,\r\n \"Instructions\": null,\r\n \"DeliveryDate\": null,\r\n \"PickingDate\": null,\r\n \"PreferentialPeriodOfDelivery\": null,\r\n \"SenderClientCode\": null,\r\n \"SenderName\": \"Envio de testes\",\r\n \"SenderContactName\": \"Envio de testes\",\r\n \"SenderContactPhoneNumber\": \"960000000\",\r\n \"SenderContactEmail\": \"testes@vasp.pt\",\r\n \"SenderAddressStreet\": \"Rua Alto do Monte, nr 3\",\r\n \"SenderAddressDoorNumber\": null,\r\n \"SenderAddressFloor\": null,\r\n \"SenderAddressPlace\": \"Lisboa\",\r\n \"SenderAddressPostalCode\": \"1000-123\",\r\n \"SenderAddressPostalCodePlace\": \"Lisboa\",\r\n \"SenderAddressCountryCode\": \"PT\",\r\n \"ReceiverClientCode\": null,\r\n \"ReceiverName\": \"Recepção de testes\",\r\n \"ReceiverContactName\": \"Recepção de testes\",\r\n \"ReceiverContactPhoneNumber\": \"960000000\",\r\n \"ReceiverContactEmail\": null,\r\n \"ReceiverAddressStreet\": \"Av do Lago, nr 5\",\r\n \"ReceiverAddressDoorNumber\": null,\r\n \"ReceiverAddressFloor\": null,\r\n \"ReceiverAddressPlace\": \"Porto\",\r\n \"ReceiverAddressPostalCode\": \"4000-123\",\r\n \"ReceiverAddressPostalCodePlace\": \"Porto\",\r\n \"ReceiverAddressCountryCode\": \"PT\",\r\n \"ReceiverFixedInstructions\": null,\r\n \"Volumes\": null,\r\n \"ClientObservations1\": null,\r\n \"ClientObservations2\": null,\r\n }\r\n}";
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://vaspapirest.vaspexpresso.pt/api/V3/Shipment/Service", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
```
#### PHP
```php=
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://vaspapirest.vaspexpresso.pt/api/V3/Shipment/Service',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"Service": {
"ServiceTypeId": 93,
"MustDeliverAtKiosStore": false,
"KiosStoreCode": null,
"ServiceFlow": 0,
"ClientReference": null,
"ClientBarCode": null,
"PinCode": null,
"NumberOfVolumes": 2,
"TotalWeightOfVolumes": 25,
"Amount": null,
"Pod": false,
"Sms": false,
"Instructions": null,
"DeliveryDate": null,
"PickingDate": null,
"PreferentialPeriodOfDelivery": null,
"SenderClientCode": null,
"SenderName": "Envio de testes",
"SenderContactName": "Envio de testes",
"SenderContactPhoneNumber": "960000000",
"SenderContactEmail": "testes@vasp.pt",
"SenderAddressStreet": "Rua Alto do Monte, nr 3",
"SenderAddressDoorNumber": null,
"SenderAddressFloor": null,
"SenderAddressPlace": "Lisboa",
"SenderAddressPostalCode": "1000-123",
"SenderAddressPostalCodePlace": "Lisboa",
"SenderAddressCountryCode": "PT",
"ReceiverClientCode": null,
"ReceiverName": "Recepção de testes",
"ReceiverContactName": "Recepção de testes",
"ReceiverContactPhoneNumber": "960000000",
"ReceiverContactEmail": null,
"ReceiverAddressStreet": "Av do Lago, nr 5",
"ReceiverAddressDoorNumber": null,
"ReceiverAddressFloor": null,
"ReceiverAddressPlace": "Porto",
"ReceiverAddressPostalCode": "4000-123",
"ReceiverAddressPostalCodePlace": "Porto",
"ReceiverAddressCountryCode": "PT",
"ReceiverFixedInstructions": null,
"Volumes": null,
"ClientObservations1": null,
"ClientObservations2": null,
}
}',
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE3NzYiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNDYzNzUxMSwiZXhwIjoxNjM0NzIzOTExLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.C9dDciSDGBjPPON8JkVUCQkIjZsmV93vAQYbhTS5wtg',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
```
#### Python
```python=
import http.client
import json
conn = http.client.HTTPSConnection("vaspapirest.vaspexpresso.pt")
payload = "{\r\n \"Service\": {\r\n \"ServiceTypeId\": 93,\r\n \"MustDeliverAtKiosStore\": false,\r\n \"KiosStoreCode\": null,\r\n \"ServiceFlow\": 0,\r\n \"ClientReference\": null,\r\n \"ClientBarCode\": null,\r\n \"PinCode\": null,\r\n \"NumberOfVolumes\": 2,\r\n \"TotalWeightOfVolumes\": 25,\r\n \"Amount\": null,\r\n \"Pod\": false,\r\n \"Sms\": false,\r\n \"Instructions\": null,\r\n \"DeliveryDate\": null,\r\n \"PickingDate\": null,\r\n\t\"PreferentialPeriodOfDelivery\": null,\r\n \"SenderClientCode\": null,\r\n \"SenderName\": \"Envio de testes\",\r\n \"SenderContactName\": \"Envio de testes\",\r\n \"SenderContactPhoneNumber\": \"960000000\",\r\n \"SenderContactEmail\": \"testes@vasp.pt\",\r\n \"SenderAddressStreet\": \"Rua Alto do Monte, nr 3\",\r\n \"SenderAddressDoorNumber\": null,\r\n \"SenderAddressFloor\": null,\r\n \"SenderAddressPlace\": \"Lisboa\",\r\n \"SenderAddressPostalCode\": \"1000-123\",\r\n \"SenderAddressPostalCodePlace\": \"Lisboa\",\r\n \"SenderAddressCountryCode\": \"PT\",\r\n \"ReceiverClientCode\": null,\r\n \"ReceiverName\": \"Recepção de testes\",\r\n \"ReceiverContactName\": \"Recepção de testes\",\r\n \"ReceiverContactPhoneNumber\": \"960000000\",\r\n \"ReceiverContactEmail\": null,\r\n \"ReceiverAddressStreet\": \"Av do Lago, nr 5\",\r\n \"ReceiverAddressDoorNumber\": null,\r\n \"ReceiverAddressFloor\": null,\r\n \"ReceiverAddressPlace\": \"Porto\",\r\n \"ReceiverAddressPostalCode\": \"4000-123\",\r\n \"ReceiverAddressPostalCodePlace\": \"Porto\",\r\n \"ReceiverAddressCountryCode\": \"PT\",\r\n \"ReceiverFixedInstructions\": null,\r\n \"Volumes\": null,\r\n \"ClientObservations1\": null,\r\n \"ClientObservations2\": null,\r\n }\r\n}"
headers = {
'Authorization': 'Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE3NzYiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNDYzNzUxMSwiZXhwIjoxNjM0NzIzOTExLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.C9dDciSDGBjPPON8JkVUCQkIjZsmV93vAQYbhTS5wtg',
'Content-Type': 'application/json'
}
conn.request("POST", "/api/V3/Shipment/Service", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
## Criar serviços em bloco
### Input
:::info
`POST /api/V3/Shipment/Services`
|Campo|Descrição|Tipo|Tamanho|Obrigatório|
|-|-|-|-|-|
|Services|Lista de serviços|Lista de services||Sim|
Service :
|Campo|Descrição|Tipo|Tamanho|Obrigatório|
|-|-|-|-|-|
|serviceTypeId|Código do tipo de serviço `(listagem fornecida abaixo)`|int||Sim|
|mustDeliverAtKiosStore|Serviço a ser entregue em Loja Kios|boolean||Não|
|kiosStoreCode|Código da Loja Kios|string|6|Não|
|serviceFlow|Característica do serviço `(Entrega = 0, PickAndReturn = 2)`|int||Sim|
|clientReference|Código de referencia do cliente|string|30|Não|
|clientBarCode|Código de barras do serviço|string|25|Não|
|pinCode|Código do pin|string|4|Não|
|numberOfVolumes|Número de volumes do serviço|int|200|Sim|
|totalWeightOfVolumes|Peso total do serviço|decimal|99999|Sim|
|amount|Valor a cobrar|decimal||Não|
|pod|Prova de entregua|boolean||Não|
|sms|Pretende enviar sms para cliente|boolean||Não|
|instructions|Instruções de envio|string|250|Não|
|deliveryDate|Data para entregua|datetime||Não|
|pickingDate|Data para recolha|datetime||Não|
|preferentialPeriodOfDelivery|Período preferencial de entrega `(ex.: 09:00-12:00 ou 09:00-12:00/14:00-18:00)`|string|23|Não|
|senderClientCode|Código do remetente|string|20|Não|
|senderName|Nome do remetente|string|100|Sim|
|senderContactName|Nome de contacto do remetente|string|200|Sim|
|senderContactPhoneNumber|Número de contacto do remetente|string|20|Não|
|senderContactEmail|E-mail de contacto do remetente|string|50|Não|
|senderAddressStreet|Morada do remetente|string|200|Sim|
|senderAddressDoorNumber|Número da porta do remetente|string|50|Não|
|senderAddressFloor|Número do andar do remetente|string|50|Não|
|senderAddressPlace|Local do remetente|string|100|Sim|
|senderAddressPostalCode|Código postal do remetente|string|10|Sim|
|senderAddressPostalCodePlace|Local postal do remetente|string|100|Sim|
|senderAddressCountryCode|Código do país do remetente `(ex.: PT ou ES)`|string|3|Sim|
|receiverClientCode|Código do destinatário|string|20|Não|
|receiverName|Nome do destinatário|string|100|Sim|
|receiverContactName|Nome de contacto do destinatário|string|200|Sim|
|receiverContactPhoneNumber|Número de contacto do destinatário|string|20|Não|
|receiverContactEmail|E-mail de contacto do destinatário|string|50|Não|
|receiverAddressStreet|Morada do destinatário|string|200|Sim|
|receiverAddressDoorNumber|Número da porta do destinatário|string|50|Não|
|receiverAddressFloor|Número do andar do destinatário|string|50|Não|
|receiverAddressPlace|Local do destinatário|string|100|Sim|
|receiverAddressPostalCode|Código postal do destinatário|string|10|Sim|
|receiverAddressPostalCodePlace|Local postal do destinatário|string|100|Sim|
|receiverAddressCountryCode|Código do país o destinatário `(ex.: PT ou ES)`|string|3|Sim|
|receiverFixedInstructions|Instruções fixas do serviço|string|250|Não|
|clientObservations1|Observações do cliente 1|string|50|Não|
|clientObservations2|Observações do cliente 2|string|50|Não|
|volumes|Volumes|Lista de volumes||Não|
Volume :
|Campo|Descrição|Tipo|Tamanho|Obrigatório|
|-|-|-|-|-|
| volumeBarCode | Código de barras do volue |string|30|Sim|
| volumeNumber | Número do volume |int||Sim|
| weight | Peso do volume |decimal||Sim|
TIpos de serviços :
| Código tipo de serviço|Descrição|
|-|-|
| 89 | Serviço de entrega de volumes |
| 90 | RECOLHA |
| 91 | TRANSFERÊNCIA |
| 92 | Serviço de entrega de paletes |
| 93 | VASP24 - Entrega volumes no dia seguinte |
| 94 | VASP10 - Entrega volumes até às dez horas do dia s |
| 95 | VASPWE - Entregas de volumes ao fim de semana |
| 96 | Entrega de volumes na rede Kios |
| 97 | VASPPAL - Entrega de paletes no dia seguinte |
| 99 | VMADAR - Entregas na Madeira por via aerea |
| 100 | VPSAAR - Entregas no Porto Santo via aerea |
| 101 | VACIAR - Entregas Açores I (S. Miguel) via aerea |
| 102 | VACIIAR - Entregas nos Açores II ( Restantes Ilhas |
| 103 | VDED - Serviço de entrega dedicada |
| 104 | VASPSAB - Entregas ao Sábado |
| 105 | VASPDOM - Entregas ao Domingo |
| 106 | VMADMAR - Entrega na Madeira via Maritima |
| 107 | VPSMAR - Entrega em Porto Santo via Marítima |
| 108 | VACIIMAR - Açores II ( restantes Ilhas) Via Maríti |
| 109 | VACIMAR - Ent. Açores I (S. Miguel) via Marítima |
| 110 | VVERDE - Recolha e Entrega Resíduos |
| 111 | VDAY - Entregas no mesmo Dia |
| 112 | VASP48 - Entrega volumes até 48 Horas |
| 113 | VASP13 - Entrega Dia seguinte até 13:00 Horas |
| 114 | VPALBASC- (Recolha Báscula) Entrega Palete Dia Seg |
| 115 | VB2CK-Particular-KIOS Entrega dia seguinte |
| 117 | VB2K-KIOS Entrega dia seguinte |
| 118 | VASP24DON - Recolha e Entrega DON |
| 119 | VASP48DOS - Recolha DON e Entrega DOS |
| 121 | VK2C24 - Recolha Kios Entrega Particular |
| 123 | VK2CIAR-Recolha Kios Entrega S. Miguel - Via Aérea |
| 124 | VK2CMAD - Recolha Kios Entrega Madeira Via Aérea |
| 125 | VKB2CDEV - Devoluções em Pontos Kios |
| 126 | VK2CINT - Recolha Kios Entrega Internacional |
| 127 | VDEV - Devoluções-Rec e Ent. no Expedidor |
| 128 | VK2C48 - Recolha Kios Entrega Particular |
| 129 | VVIST - Visita sugestão Encomenda |
| 130 | VKDEV - Devoluções KIOS |
| 131 | VTROCAS - Entrega e Recolha em Simultâneo |
| 132 | RVMADAR - Recolhas na Ilha da Madeira - Via aérea |
| 133 | VMADAR-SDIM - Entregas na SDIM - Madeira Aéreo |
| 134 | VASP05 - Entregas ás 05h |
| 135 | VASPPPROPET - Entrega "meias" paletes Propet |
| 137 | VASP24B2C - Entrega volumes B2C |
| 138 | SDIM24 - Entregas dentro do arquipélado no dia seg |
| 139 | SDIMAER - Entrega de volumes no continente |
| 140 | VRCIAR - Rec no Cont para ent nos Açores via aerea |
| 141 | VRCIMAR - Rec no Cont para ent nos Açores via mari |
| 142 | VMADCAR - Recolha na Madeira para entrega no Conti |
| 143 | VMADCMAR - Recolha na Madeira entrega no Continent |
| 144 | VACIICAR - Recolhas nos Açores II e entrega no Con |
| 145 | VACIICMAR - Recolhas nos Açores II e entrega no Co |
| 146 | VACICAR - Recolhas nos Açores I e entrega no Conti |
| 147 | VACICMAR - Recolha nos Açores I e entrega no Conti |
| 148 | Serviços de Logística |
| 149 | RECOLHA FIXA |
| 150 | RECOLHA 24 |
| 151 | Entrega no dia seguinte mailings |
| 152 | VASPPALSAB- Entrega de Paletes ao Sábado |
| 153 | Entregas Centralizadas de Paletes no Eixo Azambuja |
| 154 | VPALDEV - Serviço de devolução de paletes |
| 159 | VPALBASC - Entrega de paletes com báscula - Contin |
| 160 | VPALBASCA - Entrega de paletes c/ báscula e ajudan |
| 161 | VPALBASCH - Entrega de paletes c/ báscula e hora m |
| 162 | VB2KMA-Envios para KIOS - Madeira Aéreo |
| 163 | VB2KMM-Envios para KIOS - Madeira Marítimo |
| 164 | VB2KAA_1-Envios para KIOS - Açores Aéreo 1 |
| 165 | VB2KAM_1-Envios para KIOS - Açores Marítimo 1 |
| 166 | VB2KAA_2-Envios para KIOS - Açores Aéreo 2 |
| 167 | VB2KAM_2-Envios para KIOS - Açores Marítimo 2 |
| 175 | VASPPAL_MEIA - Entrega de meias paletes |
| 176 | VASPINT Envio Internacional |
| 177 | VNIGHT - Serviço de Entregas à noite |
| 178 | VPALAM - Entrega de paletes americanas |
| 179 | VPALMADMAR - Envio de Paletes para a Madeira Marít |
| 180 | VASPPALDOM - Entrega de Paletes ao Domingo |
| 181 | SDIM12 - Entregas dentro do arquipélago até 12h |
| 182 | SDIM Serviço dedicado |
| 183 | SDIM Serviço PHARMA |
| 184 | VPALW - Paletes Wurth |
:::
### Output
::: success
**OK : 200**
Resposta do pedido :
|Campo|Descrição|Tipo|
|-|-|-|
|Services|Lista de serviços|Lista de services|
Service :
|Campo|Descrição|Tipo|
|-|-|-|
|service | Serviço criado | Service |
|description | Descrição do código http da operação (ex.: OK) | string |
|result | Número do código http da operação (ex.: 200) | string |
Service :
|Campo|Descrição|Tipo|
|-|-|-|
| serviceType | Descrição do tipo de serviço |ServiceType|
| kiosStore | Descrição do ponto de entrega (Loja Kios) |KiosStore|
| amount |Valor a cobrar|decimal|
| clientBarCode |Código de barras do serviço|string|
| clientReference |Código de referencia do cliente|string|
| deliveryDate |Data para entregua|datetime|
| pickingDate |Data para recolha|datetime|
| mustDeliverAtKiosStore |Serviço a ser entregue em Loja Kios|boolean|
| receiver | Descrição do destinatário | Receiver |
| receiverFixedInstructions |Instruções fixas do serviço|string|
| serviceFlow |Característica do serviço|int|
| sender | Descrição do remetente | Sender |
| volumes | Descrição dos volumes | Volumes |
| numberOfVolumes |Número de volumes do serviço|int|
ServiceType :
|Campo|Descrição|Tipo|
|-|-|-|
|serviceTypeId|Código do tipo de serviço |int|
|name|Nome do tipo de serviço |string|
|serviceType|Abreviação do tipo de serviço |string|
KiosStore :
|Campo|Descrição|Tipo|
|-|-|-|
|businessName|Nome de Loja Kios|string|
|businessPhone|Número de contacto|string|
|code|Código de Loja Kios|string|
|name|Nome do proprietário|string|
|address|Morada|string|
|postalCode|Código postal|string|
|postalCodePlace|Localidade postal|string|
|email|E-mail|string|
|municipality|Município|string|
|district|Distrito|string|
|longitude|Longitude|decimal|
|latitude|Latitude|decimal|
|weekSchedule|Horário da semana|string|
|saturdaySchedule|Horário de Sábado|string|
|sundaySchedule|Horário de Domingo|string|
|isOpenLocalHoliday|Aberto em feriados locais|boolean|
|isOpenNationalHoliday|Aberto em feriados nacionais|boolean|
|isOpenHolidayNextDay|Aberto no dia seguinte a feriado|boolean|
|isActive|Activo|boolean|
Sender :
|Campo|Descrição|Tipo|
|-|-|-|
|Code|Código do remetente|string|
|Name|Nome do remetente|string|
|Contact|Nome de contacto do remetente|string|
|Telephone|Número de contacto do remetente|string|
|ContactEmail|E-mail de contacto do remetente|string|
|Address|Morada do remetente|string|
|Place|Local do remetente|string|
|PostalCode|Código postal do remetente|string|
|PostalPlace|Local postal do remetente|string|
|Country|Código do país do remetente `(ex.: PT ou ES)`|string|
Receiver :
|Campo|Descrição|Tipo|
|-|-|-|
|Code|Código do remetente|string|
|Name|Nome do remetente|string|
|Contact|Nome de contacto do remetente|string|
|Telephone|Número de contacto do remetente|string|
|ContactEmail|E-mail de contacto do remetente|string|
|Address|Morada do remetente|string|
|Place|Local do remetente|string|
|PostalCode|Código postal do remetente|string|
|PostalPlace|Local postal do remetente|string|
|Country|Código do país do remetente `(ex.: PT ou ES)`|string|
Volume :
|Campo|Descrição|Tipo|
|-|-|-|
| volumeBarCode | Código de barras do volue |string|
| volumeNumber | Número do volume |int|
| weight | Peso do volume |decimal|
Erro :
|Campo|Descrição|Exemplo|
|-|-|-|
|message|Mensagem de erro|
|status|Status HTTP|400|
:::
:::warning
**Unauthorized : 401**
Token de autorização invalido ou expirado.
:::
### Código Exemplo
#### cURL
```curl=
curl --location --request POST 'https://vaspapirest.vaspexpresso.pt/api/V3/Shipment/Services' \
--header 'Authorization: Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE3NzYiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNDYzNzUxMSwiZXhwIjoxNjM0NzIzOTExLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.C9dDciSDGBjPPON8JkVUCQkIjZsmV93vAQYbhTS5wtg' \
--header 'Content-Type: application/json' \
--data-raw '
{
"Services":[
{
"ServiceTypeId": 93,
"MustDeliverAtKiosStore": false,
"KiosStoreCode": null,
"ServiceFlow": 0,
"ClientReference": null,
"ClientBarCode": null,
"PinCode": null,
"NumberOfVolumes": 2,
"TotalWeightOfVolumes": 25,
"Amount": null,
"Pod": false,
"Sms": false,
"Instructions": null,
"DeliveryDate": null,
"PickingDate": null,
"PreferentialPeriodOfDelivery": null,
"SenderClientCode": null,
"SenderName": "Envio de testes",
"SenderContactName": "Envio de testes",
"SenderContactPhoneNumber": "960000000",
"SenderContactEmail": "testes@vasp.pt",
"SenderAddressStreet": "Rua Alto do Monte, nr 3",
"SenderAddressDoorNumber": null,
"SenderAddressFloor": null,
"SenderAddressPlace": "Lisboa",
"SenderAddressPostalCode": "1000-123",
"SenderAddressPostalCodePlace": "Lisboa",
"SenderAddressCountryCode": "PT",
"ReceiverClientCode": null,
"ReceiverName": "Recepção de testes",
"ReceiverContactName": "Recepção de testes",
"ReceiverContactPhoneNumber": "960000000",
"ReceiverContactEmail": null,
"ReceiverAddressStreet": "Av do Lago, nr 5",
"ReceiverAddressDoorNumber": null,
"ReceiverAddressFloor": null,
"ReceiverAddressPlace": "Porto",
"ReceiverAddressPostalCode": "4000-123",
"ReceiverAddressPostalCodePlace": "Porto",
"ReceiverAddressCountryCode": "PT",
"ReceiverFixedInstructions": null,
"Volumes": null,
"ClientObservations1": null,
"ClientObservations2": null
}
]
}
'
```
#### C#
```csharp=
var client = new RestClient("https://vaspapirest.vaspexpresso.pt/api/V3/Shipment/Services");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE3NzYiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNDYzNzUxMSwiZXhwIjoxNjM0NzIzOTExLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.C9dDciSDGBjPPON8JkVUCQkIjZsmV93vAQYbhTS5wtg");
request.AddHeader("Content-Type", "application/json");
var body = @"
" + "\n" +
@"{
" + "\n" +
@" ""Services"":[
" + "\n" +
@" {
" + "\n" +
" + "\n" +
@" ""ServiceTypeId"": 93,
" + "\n" +
@" ""MustDeliverAtKiosStore"": false,
" + "\n" +
@" ""KiosStoreCode"": null,
" + "\n" +
@" ""ServiceFlow"": 0,
" + "\n" +
@" ""ClientReference"": null,
" + "\n" +
@" ""ClientBarCode"": null,
" + "\n" +
@" ""PinCode"": null,
" + "\n" +
@" ""NumberOfVolumes"": 2,
" + "\n" +
@" ""TotalWeightOfVolumes"": 25,
" + "\n" +
@" ""Amount"": null,
" + "\n" +
@" ""Pod"": false,
" + "\n" +
@" ""Sms"": false,
" + "\n" +
@" ""Instructions"": null,
" + "\n" +
@" ""DeliveryDate"": null,
" + "\n" +
@" ""PickingDate"": null,
" + "\n" +
@" ""PreferentialPeriodOfDelivery"": null,
" + "\n" +
@" ""SenderClientCode"": null,
" + "\n" +
@" ""SenderName"": ""Envio de testes"",
" + "\n" +
@" ""SenderContactName"": ""Envio de testes"",
" + "\n" +
@" ""SenderContactPhoneNumber"": ""960000000"",
" + "\n" +
@" ""SenderContactEmail"": ""testes@vasp.pt"",
" + "\n" +
@" ""SenderAddressStreet"": ""Rua Alto do Monte, nr 3"",
" + "\n" +
@" ""SenderAddressDoorNumber"": null,
" + "\n" +
@" ""SenderAddressFloor"": null,
" + "\n" +
@" ""SenderAddressPlace"": ""Lisboa"",
" + "\n" +
@" ""SenderAddressPostalCode"": ""1000-123"",
" + "\n" +
@" ""SenderAddressPostalCodePlace"": ""Lisboa"",
" + "\n" +
@" ""SenderAddressCountryCode"": ""PT"",
" + "\n" +
@" ""ReceiverClientCode"": null,
" + "\n" +
@" ""ReceiverName"": ""Recepção de testes"",
" + "\n" +
@" ""ReceiverContactName"": ""Recepção de testes"",
" + "\n" +
@" ""ReceiverContactPhoneNumber"": ""960000000"",
" + "\n" +
@" ""ReceiverContactEmail"": null,
" + "\n" +
@" ""ReceiverAddressStreet"": ""Av do Lago, nr 5"",
" + "\n" +
@" ""ReceiverAddressDoorNumber"": null,
" + "\n" +
@" ""ReceiverAddressFloor"": null,
" + "\n" +
@" ""ReceiverAddressPlace"": ""Porto"",
" + "\n" +
@" ""ReceiverAddressPostalCode"": ""4000-123"",
" + "\n" +
@" ""ReceiverAddressPostalCodePlace"": ""Porto"",
" + "\n" +
@" ""ReceiverAddressCountryCode"": ""PT"",
" + "\n" +
@" ""ReceiverFixedInstructions"": null,
" + "\n" +
@" ""Volumes"": null,
" + "\n" +
@" ""ClientObservations1"": null,
" + "\n" +
@" ""ClientObservations2"": null
" + "\n" +
" + "\n" +
@" }
" + "\n" +
@" ]
" + "\n" +
@"}
" + "\n" +
@"";
request.AddParameter("application/json", body, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
```
#### Java
```java=
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://vaspapirest.vaspexpresso.pt/api/V3/Shipment/Services")
.header("Authorization", "Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE3NzYiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNDYzNzUxMSwiZXhwIjoxNjM0NzIzOTExLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.C9dDciSDGBjPPON8JkVUCQkIjZsmV93vAQYbhTS5wtg")
.header("Content-Type", "application/json")
.body("\r\n{\r\n \"Services\":[\r\n {\r\n \"ServiceTypeId\": 93,\r\n \"MustDeliverAtKiosStore\": false,\r\n \"KiosStoreCode\": null,\r\n \"ServiceFlow\": 0,\r\n \"ClientReference\": null,\r\n \"ClientBarCode\": null,\r\n \"PinCode\": null,\r\n \"NumberOfVolumes\": 2,\r\n \"TotalWeightOfVolumes\": 25,\r\n \"Amount\": null,\r\n \"Pod\": false,\r\n \"Sms\": false,\r\n \"Instructions\": null,\r\n \"DeliveryDate\": null,\r\n \"PickingDate\": null,\r\n \"PreferentialPeriodOfDelivery\": null,\r\n \"SenderClientCode\": null,\r\n \"SenderName\": \"Envio de testes\",\r\n \"SenderContactName\": \"Envio de testes\",\r\n \"SenderContactPhoneNumber\": \"960000000\",\r\n \"SenderContactEmail\": \"testes@vasp.pt\",\r\n \"SenderAddressStreet\": \"Rua Alto do Monte, nr 3\",\r\n \"SenderAddressDoorNumber\": null,\r\n \"SenderAddressFloor\": null,\r\n \"SenderAddressPlace\": \"Lisboa\",\r\n \"SenderAddressPostalCode\": \"1000-123\",\r\n \"SenderAddressPostalCodePlace\": \"Lisboa\",\r\n \"SenderAddressCountryCode\": \"PT\",\r\n \"ReceiverClientCode\": null,\r\n \"ReceiverName\": \"Recepção de testes\",\r\n \"ReceiverContactName\": \"Recepção de testes\",\r\n \"ReceiverContactPhoneNumber\": \"960000000\",\r\n \"ReceiverContactEmail\": null,\r\n \"ReceiverAddressStreet\": \"Av do Lago, nr 5\",\r\n \"ReceiverAddressDoorNumber\": null,\r\n \"ReceiverAddressFloor\": null,\r\n \"ReceiverAddressPlace\": \"Porto\",\r\n \"ReceiverAddressPostalCode\": \"4000-123\",\r\n \"ReceiverAddressPostalCodePlace\": \"Porto\",\r\n \"ReceiverAddressCountryCode\": \"PT\",\r\n \"ReceiverFixedInstructions\": null,\r\n \"Volumes\": null,\r\n \"ClientObservations1\": null,\r\n \"ClientObservations2\": null\r\n }\r\n ]\r\n}\r\n")
.asString();
```
#### Javascript
```javascript=
var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE3NzYiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNDYzNzUxMSwiZXhwIjoxNjM0NzIzOTExLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.C9dDciSDGBjPPON8JkVUCQkIjZsmV93vAQYbhTS5wtg");
myHeaders.append("Content-Type", "application/json");
var raw = "\r\n{\r\n \"Services\":[\r\n {\r\n \"ServiceTypeId\": 93,\r\n \"MustDeliverAtKiosStore\": false,\r\n \"KiosStoreCode\": null,\r\n \"ServiceFlow\": 0,\r\n \"ClientReference\": null,\r\n \"ClientBarCode\": null,\r\n \"PinCode\": null,\r\n \"NumberOfVolumes\": 2,\r\n \"TotalWeightOfVolumes\": 25,\r\n \"Amount\": null,\r\n \"Pod\": false,\r\n \"Sms\": false,\r\n \"Instructions\": null,\r\n \"DeliveryDate\": null,\r\n \"PickingDate\": null,\r\n \"PreferentialPeriodOfDelivery\": null,\r\n \"SenderClientCode\": null,\r\n \"SenderName\": \"Envio de testes\",\r\n \"SenderContactName\": \"Envio de testes\",\r\n \"SenderContactPhoneNumber\": \"960000000\",\r\n \"SenderContactEmail\": \"testes@vasp.pt\",\r\n \"SenderAddressStreet\": \"Rua Alto do Monte, nr 3\",\r\n \"SenderAddressDoorNumber\": null,\r\n \"SenderAddressFloor\": null,\r\n \"SenderAddressPlace\": \"Lisboa\",\r\n \"SenderAddressPostalCode\": \"1000-123\",\r\n \"SenderAddressPostalCodePlace\": \"Lisboa\",\r\n \"SenderAddressCountryCode\": \"PT\",\r\n \"ReceiverClientCode\": null,\r\n \"ReceiverName\": \"Recepção de testes\",\r\n \"ReceiverContactName\": \"Recepção de testes\",\r\n \"ReceiverContactPhoneNumber\": \"960000000\",\r\n \"ReceiverContactEmail\": null,\r\n \"ReceiverAddressStreet\": \"Av do Lago, nr 5\",\r\n \"ReceiverAddressDoorNumber\": null,\r\n \"ReceiverAddressFloor\": null,\r\n \"ReceiverAddressPlace\": \"Porto\",\r\n \"ReceiverAddressPostalCode\": \"4000-123\",\r\n \"ReceiverAddressPostalCodePlace\": \"Porto\",\r\n \"ReceiverAddressCountryCode\": \"PT\",\r\n \"ReceiverFixedInstructions\": null,\r\n \"Volumes\": null,\r\n \"ClientObservations1\": null,\r\n \"ClientObservations2\": null\r\n }\r\n ]\r\n}\r\n";
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://vaspapirest.vaspexpresso.pt/api/V3/Shipment/Services", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
```
#### PHP
```php=
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://vaspapirest.vaspexpresso.pt/api/V3/Shipment/Services',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'
{
"Services":[
{
"ServiceTypeId": 93,
"MustDeliverAtKiosStore": false,
"KiosStoreCode": null,
"ServiceFlow": 0,
"ClientReference": null,
"ClientBarCode": null,
"PinCode": null,
"NumberOfVolumes": 2,
"TotalWeightOfVolumes": 25,
"Amount": null,
"Pod": false,
"Sms": false,
"Instructions": null,
"DeliveryDate": null,
"PickingDate": null,
"PreferentialPeriodOfDelivery": null,
"SenderClientCode": null,
"SenderName": "Envio de testes",
"SenderContactName": "Envio de testes",
"SenderContactPhoneNumber": "960000000",
"SenderContactEmail": "testes@vasp.pt",
"SenderAddressStreet": "Rua Alto do Monte, nr 3",
"SenderAddressDoorNumber": null,
"SenderAddressFloor": null,
"SenderAddressPlace": "Lisboa",
"SenderAddressPostalCode": "1000-123",
"SenderAddressPostalCodePlace": "Lisboa",
"SenderAddressCountryCode": "PT",
"ReceiverClientCode": null,
"ReceiverName": "Recepção de testes",
"ReceiverContactName": "Recepção de testes",
"ReceiverContactPhoneNumber": "960000000",
"ReceiverContactEmail": null,
"ReceiverAddressStreet": "Av do Lago, nr 5",
"ReceiverAddressDoorNumber": null,
"ReceiverAddressFloor": null,
"ReceiverAddressPlace": "Porto",
"ReceiverAddressPostalCode": "4000-123",
"ReceiverAddressPostalCodePlace": "Porto",
"ReceiverAddressCountryCode": "PT",
"ReceiverFixedInstructions": null,
"Volumes": null,
"ClientObservations1": null,
"ClientObservations2": null
}
]
}
',
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE3NzYiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNDYzNzUxMSwiZXhwIjoxNjM0NzIzOTExLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.C9dDciSDGBjPPON8JkVUCQkIjZsmV93vAQYbhTS5wtg',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
```
#### Python
```python=
import http.client
import json
conn = http.client.HTTPSConnection("vaspapirest.vaspexpresso.pt")
payload = "\r\n{\r\n \"Services\":[\r\n {\r\n \"ServiceTypeId\": 93,\r\n \"MustDeliverAtKiosStore\": false,\r\n \"KiosStoreCode\": null,\r\n \"ServiceFlow\": 0,\r\n \"ClientReference\": null,\r\n \"ClientBarCode\": null,\r\n \"PinCode\": null,\r\n \"NumberOfVolumes\": 2,\r\n \"TotalWeightOfVolumes\": 25,\r\n \"Amount\": null,\r\n \"Pod\": false,\r\n \"Sms\": false,\r\n \"Instructions\": null,\r\n \"DeliveryDate\": null,\r\n \"PickingDate\": null,\r\n \"PreferentialPeriodOfDelivery\": null,\r\n \"SenderClientCode\": null,\r\n \"SenderName\": \"Envio de testes\",\r\n \"SenderContactName\": \"Envio de testes\",\r\n \"SenderContactPhoneNumber\": \"960000000\",\r\n \"SenderContactEmail\": \"testes@vasp.pt\",\r\n \"SenderAddressStreet\": \"Rua Alto do Monte, nr 3\",\r\n \"SenderAddressDoorNumber\": null,\r\n \"SenderAddressFloor\": null,\r\n \"SenderAddressPlace\": \"Lisboa\",\r\n \"SenderAddressPostalCode\": \"1000-123\",\r\n \"SenderAddressPostalCodePlace\": \"Lisboa\",\r\n \"SenderAddressCountryCode\": \"PT\",\r\n \"ReceiverClientCode\": null,\r\n \"ReceiverName\": \"Recepção de testes\",\r\n \"ReceiverContactName\": \"Recepção de testes\",\r\n \"ReceiverContactPhoneNumber\": \"960000000\",\r\n \"ReceiverContactEmail\": null,\r\n \"ReceiverAddressStreet\": \"Av do Lago, nr 5\",\r\n \"ReceiverAddressDoorNumber\": null,\r\n \"ReceiverAddressFloor\": null,\r\n \"ReceiverAddressPlace\": \"Porto\",\r\n \"ReceiverAddressPostalCode\": \"4000-123\",\r\n \"ReceiverAddressPostalCodePlace\": \"Porto\",\r\n \"ReceiverAddressCountryCode\": \"PT\",\r\n \"ReceiverFixedInstructions\": null,\r\n \"Volumes\": null,\r\n \"ClientObservations1\": null,\r\n \"ClientObservations2\": null,\r\n }\r\n ]\r\n}\r\n"
headers = {
'Authorization': 'Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE3NzYiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNDYzNzUxMSwiZXhwIjoxNjM0NzIzOTExLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.C9dDciSDGBjPPON8JkVUCQkIjZsmV93vAQYbhTS5wtg',
'Content-Type': 'application/json'
}
conn.request("POST", "/api/V3/Shipment/Services", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
## Criar serviço com devolução de etiqueta
### Input
:::info
`POST /api/V3/Shipment/Service/Label/LabelType/{labelType}/{labelSize}`
LabelType :
|Parâmetro|Descrição|Documentação|
|-|-|-|
|ZPL|Etiqueta do tipo Zebra ZPL| https://www.zebra.com/us/en/support-downloads/knowledge-articles/zpl-command-information-and-details.html |
|EPL|Etiqueta do tipo Zebra EPL | https://www.zebra.com/us/en/support-downloads/knowledge-articles/ait/epl2-command-information-and-details.html |
|PDF|Etiqueta do tipo PDF||
LabelSize:
|Parâmetro|Descrição|
|-|-|
|A5|Tamanho A5|
|A6|Tamanho A6|
Obs: O parâmetro LabelSize é opcional e é apenas utilizado no tipo de etiqueta PDF - Caso a etiqueta seja do tipo PDF e se não for enviado o parâmetro labelSize a etiqueta sai no formato 10cmx15cm (tamanho padrão). No caso de ser o formato EPL ou ZPL mesmo enviando o parâmetro LabelSize o mesmo não irá ser considerado.
Service :
|Campo|Descrição|Tipo|Tamanho|Obrigatório|
|-|-|-|-|-|
|serviceTypeId|Código do tipo de serviço `(listagem fornecida abaixo)`|int||Sim|
|mustDeliverAtKiosStore|Serviço a ser entregue em Loja Kios|boolean||Não|
|kiosStoreCode|Código da Loja Kios|string|6|Não|
|serviceFlow|Característica do serviço `(Entrega = 0, PickAndReturn = 2)`|int||Sim|
|clientReference|Código de referencia do cliente|string|30|Não|
|clientBarCode|Código de barras do serviço|string|25|Não|
|pinCode|Código do pin|string|4|Não|
|numberOfVolumes|Número de volumes do serviço|int|200|Sim|
|totalWeightOfVolumes|Peso total do serviço|decimal|99999|Sim|
|amount|Valor a cobrar|decimal||Não|
|pod|Prova de entregua|boolean||Não|
|sms|Pretende enviar sms para cliente|boolean||Não|
|instructions|Instruções de envio|string|250|Não|
|deliveryDate|Data para entregua|datetime||Não|
|pickingDate|Data para recolha|datetime||Não|
|preferentialPeriodOfDelivery|Período preferencial de entrega `(ex.: 09:00-12:00 ou 09:00-12:00/14:00-18:00)`|string|23|Não|
|senderClientCode|Código do remetente|string|20|Não|
|senderName|Nome do remetente|string|100|Sim|
|senderContactName|Nome de contacto do remetente|string|200|Sim|
|senderContactPhoneNumber|Número de contacto do remetente|string|20|Não|
|senderContactEmail|E-mail de contacto do remetente|string|50|Não|
|senderAddressStreet|Morada do remetente|string|200|Sim|
|senderAddressDoorNumber|Número da porta do remetente|string|50|Não|
|senderAddressFloor|Número do andar do remetente|string|50|Não|
|senderAddressPlace|Local do remetente|string|100|Sim|
|senderAddressPostalCode|Código postal do remetente|string|10|Sim|
|senderAddressPostalCodePlace|Local postal do remetente|string|100|Sim|
|senderAddressCountryCode|Código do país do remetente `(ex.: PT ou ES)`|string|3|Sim|
|receiverClientCode|Código do destinatário|string|20|Não|
|receiverName|Nome do destinatário|string|100|Sim|
|receiverContactName|Nome de contacto do destinatário|string|200|Sim|
|receiverContactPhoneNumber|Número de contacto do destinatário|string|20|Não|
|receiverContactEmail|E-mail de contacto do destinatário|string|50|Não|
|receiverAddressStreet|Morada do destinatário|string|200|Sim|
|receiverAddressDoorNumber|Número da porta do destinatário|string|50|Não|
|receiverAddressFloor|Número do andar do destinatário|string|50|Não|
|receiverAddressPlace|Local do destinatário|string|100|Sim|
|receiverAddressPostalCode|Código postal do destinatário|string|10|Sim|
|receiverAddressPostalCodePlace|Local postal do destinatário|string|100|Sim|
|receiverAddressCountryCode|Código do país o destinatário `(ex.: PT ou ES)`|string|3|Sim|
|receiverFixedInstructions|Instruções fixas do serviço|string|250|Não|
|clientObservations1|Observações do cliente 1|string|50|Não|
|clientObservations2|Observações do cliente 2|string|50|Não|
|volumes|Volumes|Lista de volumes||Não|
Volume :
|Campo|Descrição|Tipo|Tamanho|Obrigatório|
|-|-|-|-|-|
| volumeBarCode | Código de barras do volue |string|30|Sim|
| volumeNumber | Número do volume |int||Sim|
| weight | Peso do volume |decimal||Sim|
TIpos de serviços :
| Código tipo de serviço|Descrição|
|-|-|
| 89 | Serviço de entrega de volumes |
| 90 | RECOLHA |
| 91 | TRANSFERÊNCIA |
| 92 | Serviço de entrega de paletes |
| 93 | VASP24 - Entrega volumes no dia seguinte |
| 94 | VASP10 - Entrega volumes até às dez horas do dia s |
| 95 | VASPWE - Entregas de volumes ao fim de semana |
| 96 | Entrega de volumes na rede Kios |
| 97 | VASPPAL - Entrega de paletes no dia seguinte |
| 99 | VMADAR - Entregas na Madeira por via aerea |
| 100 | VPSAAR - Entregas no Porto Santo via aerea |
| 101 | VACIAR - Entregas Açores I (S. Miguel) via aerea |
| 102 | VACIIAR - Entregas nos Açores II ( Restantes Ilhas |
| 103 | VDED - Serviço de entrega dedicada |
| 104 | VASPSAB - Entregas ao Sábado |
| 105 | VASPDOM - Entregas ao Domingo |
| 106 | VMADMAR - Entrega na Madeira via Maritima |
| 107 | VPSMAR - Entrega em Porto Santo via Marítima |
| 108 | VACIIMAR - Açores II ( restantes Ilhas) Via Maríti |
| 109 | VACIMAR - Ent. Açores I (S. Miguel) via Marítima |
| 110 | VVERDE - Recolha e Entrega Resíduos |
| 111 | VDAY - Entregas no mesmo Dia |
| 112 | VASP48 - Entrega volumes até 48 Horas |
| 113 | VASP13 - Entrega Dia seguinte até 13:00 Horas |
| 114 | VPALBASC- (Recolha Báscula) Entrega Palete Dia Seg |
| 115 | VB2CK-Particular-KIOS Entrega dia seguinte |
| 117 | VB2K-KIOS Entrega dia seguinte |
| 118 | VASP24DON - Recolha e Entrega DON |
| 119 | VASP48DOS - Recolha DON e Entrega DOS |
| 121 | VK2C24 - Recolha Kios Entrega Particular |
| 123 | VK2CIAR-Recolha Kios Entrega S. Miguel - Via Aérea |
| 124 | VK2CMAD - Recolha Kios Entrega Madeira Via Aérea |
| 125 | VKB2CDEV - Devoluções em Pontos Kios |
| 126 | VK2CINT - Recolha Kios Entrega Internacional |
| 127 | VDEV - Devoluções-Rec e Ent. no Expedidor |
| 128 | VK2C48 - Recolha Kios Entrega Particular |
| 129 | VVIST - Visita sugestão Encomenda |
| 130 | VKDEV - Devoluções KIOS |
| 131 | VTROCAS - Entrega e Recolha em Simultâneo |
| 132 | RVMADAR - Recolhas na Ilha da Madeira - Via aérea |
| 133 | VMADAR-SDIM - Entregas na SDIM - Madeira Aéreo |
| 134 | VASP05 - Entregas ás 05h |
| 135 | VASPPPROPET - Entrega "meias" paletes Propet |
| 137 | VASP24B2C - Entrega volumes B2C |
| 138 | SDIM24 - Entregas dentro do arquipélado no dia seg |
| 139 | SDIMAER - Entrega de volumes no continente |
| 140 | VRCIAR - Rec no Cont para ent nos Açores via aerea |
| 141 | VRCIMAR - Rec no Cont para ent nos Açores via mari |
| 142 | VMADCAR - Recolha na Madeira para entrega no Conti |
| 143 | VMADCMAR - Recolha na Madeira entrega no Continent |
| 144 | VACIICAR - Recolhas nos Açores II e entrega no Con |
| 145 | VACIICMAR - Recolhas nos Açores II e entrega no Co |
| 146 | VACICAR - Recolhas nos Açores I e entrega no Conti |
| 147 | VACICMAR - Recolha nos Açores I e entrega no Conti |
| 148 | Serviços de Logística |
| 149 | RECOLHA FIXA |
| 150 | RECOLHA 24 |
| 151 | Entrega no dia seguinte mailings |
| 152 | VASPPALSAB- Entrega de Paletes ao Sábado |
| 153 | Entregas Centralizadas de Paletes no Eixo Azambuja |
| 154 | VPALDEV - Serviço de devolução de paletes |
| 159 | VPALBASC - Entrega de paletes com báscula - Contin |
| 160 | VPALBASCA - Entrega de paletes c/ báscula e ajudan |
| 161 | VPALBASCH - Entrega de paletes c/ báscula e hora m |
| 162 | VB2KMA-Envios para KIOS - Madeira Aéreo |
| 163 | VB2KMM-Envios para KIOS - Madeira Marítimo |
| 164 | VB2KAA_1-Envios para KIOS - Açores Aéreo 1 |
| 165 | VB2KAM_1-Envios para KIOS - Açores Marítimo 1 |
| 166 | VB2KAA_2-Envios para KIOS - Açores Aéreo 2 |
| 167 | VB2KAM_2-Envios para KIOS - Açores Marítimo 2 |
| 175 | VASPPAL_MEIA - Entrega de meias paletes |
| 176 | VASPINT Envio Internacional |
| 177 | VNIGHT - Serviço de Entregas à noite |
| 178 | VPALAM - Entrega de paletes americanas |
| 179 | VPALMADMAR - Envio de Paletes para a Madeira Marít |
| 180 | VASPPALDOM - Entrega de Paletes ao Domingo |
| 181 | SDIM12 - Entregas dentro do arquipélago até 12h |
| 182 | SDIM Serviço dedicado |
| 183 | SDIM Serviço PHARMA |
| 184 | VPALW - Paletes Wurth |
:::
### Output
::: success
**OK : 200**
Resposta do pedido :
|Campo|Descrição|Tipo|
|-|-|-|
|service | Serviço criado | Service |
|description | Descrição do código http da operação `(ex.: OK)` | string |
|result | Número do código http da operação `(ex.: 200)` | string |
|labels|Lista de etiquetas|Array de strings (Quando é no formato pdf retorna a string codificada em base64)|
Service :
|Campo|Descrição|Tipo|
|-|-|-|
| serviceType | Descrição do tipo de serviço |ServiceType|
| kiosStore | Descrição do ponto de entrega (Loja Kios) |KiosStore|
| amount |Valor a cobrar|decimal|
| clientBarCode |Código de barras do serviço|string|
| clientReference |Código de referencia do cliente|string|
| deliveryDate |Data para entregua|datetime|
| pickingDate |Data para recolha|datetime|
| mustDeliverAtKiosStore |Serviço a ser entregue em Loja Kios|boolean|
| receiver | Descrição do destinatário | Receiver |
| receiverFixedInstructions |Instruções fixas do serviço|string|
| serviceFlow |Característica do serviço|int|
| sender | Descrição do remetente | Sender |
| volumes | Descrição dos volumes | Volumes |
| numberOfVolumes |Número de volumes do serviço|int|
ServiceType :
|Campo|Descrição|Tipo|
|-|-|-|
|serviceTypeId|Código do tipo de serviço |int|
|name|Nome do tipo de serviço |string|
|serviceType|Abreviação do tipo de serviço |string|
KiosStore :
|Campo|Descrição|Tipo|
|-|-|-|
|businessName|Nome de Loja Kios|string|
|businessPhone|Número de contacto|string|
|code|Código de Loja Kios|string|
|name|Nome do proprietário|string|
|address|Morada|string|
|postalCode|Código postal|string|
|postalCodePlace|Localidade postal|string|
|email|E-mail|string|
|municipality|Município|string|
|district|Distrito|string|
|longitude|Longitude|decimal|
|latitude|Latitude|decimal|
|weekSchedule|Horário da semana|string|
|saturdaySchedule|Horário de Sábado|string|
|sundaySchedule|Horário de Domingo|string|
|isOpenLocalHoliday|Aberto em feriados locais|boolean|
|isOpenNationalHoliday|Aberto em feriados nacionais|boolean|
|isOpenHolidayNextDay|Aberto no dia seguinte a feriado|boolean|
|isActive|Activo|boolean|
Sender :
|Campo|Descrição|Tipo|
|-|-|-|
|Code|Código do remetente|string|
|Name|Nome do remetente|string|
|Contact|Nome de contacto do remetente|string|
|Telephone|Número de contacto do remetente|string|
|ContactEmail|E-mail de contacto do remetente|string|
|Address|Morada do remetente|string|
|Place|Local do remetente|string|
|PostalCode|Código postal do remetente|string|
|PostalPlace|Local postal do remetente|string|
|Country|Código do país do remetente `(ex.: PT ou ES)`|string|
Receiver :
|Campo|Descrição|Tipo|
|-|-|-|
|Code|Código do remetente|string|
|Name|Nome do remetente|string|
|Contact|Nome de contacto do remetente|string|
|Telephone|Número de contacto do remetente|string|
|ContactEmail|E-mail de contacto do remetente|string|
|Address|Morada do remetente|string|
|Place|Local do remetente|string|
|PostalCode|Código postal do remetente|string|
|PostalPlace|Local postal do remetente|string|
|Country|Código do país do remetente `(ex.: PT ou ES)`|string|
Volume :
|Campo|Descrição|Tipo|
|-|-|-|
| volumeBarCode | Código de barras do volue |string|
| volumeNumber | Número do volume |int|
| weight | Peso do volume |decimal|
Erro :
|Campo|Descrição|Exemplo|
|-|-|-|
|message|Mensagem de erro|
|status|Status HTTP|400|
:::
:::warning
**Unauthorized : 401**
Token de autorização invalido ou expirado.
:::
### Código Exemplo
#### cURL
```curl=
curl --location --request POST 'https://vaspapirest.vaspexpresso.pt/api/V3/Shipment/Service/Label/LabelType/ZPL' \
--header 'Authorization: Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE0NTAiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNjcxOTY0MywiZXhwIjoxNjM2ODA2MDQzLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.k8NzkdGzaNnZ3YrueZpnhvIoX-s6yrnRVkWo7D7SnqE' \
--header 'Content-Type: application/json' \
--data-raw '{
"Service":{
"ServiceTypeId":93,
"MustDeliverAtKiosStore":false,
"KiosStoreCode":null,
"ServiceFlow":0,
"ClientReference":null,
"ClientBarCode":null,
"PinCode":null,
"NumberOfVolumes":2,
"TotalWeightOfVolumes":25,
"Amount":null,
"Pod":false,
"Sms":false,
"Instructions":null,
"DeliveryDate":null,
"PickingDate":null,
"PreferentialPeriodOfDelivery":null,
"SenderClientCode":null,
"SenderName":"Envio de testes",
"SenderContactName":"Envio de testes",
"SenderContactPhoneNumber":"960000000",
"SenderContactEmail":"testes@vasp.pt",
"SenderAddressStreet":"Rua Alto do Monte, nr 3",
"SenderAddressDoorNumber":null,
"SenderAddressFloor":null,
"SenderAddressPlace":"Lisboa",
"SenderAddressPostalCode":"1000-123",
"SenderAddressPostalCodePlace":"Lisboa",
"SenderAddressCountryCode":"PT",
"ReceiverClientCode":null,
"ReceiverName":"Recepção de testes",
"ReceiverContactName":"Recepção de testes",
"ReceiverContactPhoneNumber":"960000000",
"ReceiverContactEmail":null,
"ReceiverAddressStreet":"Av do Lago, nr 5",
"ReceiverAddressDoorNumber":null,
"ReceiverAddressFloor":null,
"ReceiverAddressPlace":"Porto",
"ReceiverAddressPostalCode":"4000-123",
"ReceiverAddressPostalCodePlace":"Porto",
"ReceiverAddressCountryCode":"PT",
"ReceiverFixedInstructions":null,
"Volumes":null,
"ClientObservations1":null,
"ClientObservations2":null
}
}
'
```
#### C#
```csharp=
var client = new RestClient("https://vaspapirest.vaspexpresso.pt/api/V3/Shipment/Service/Label/LabelType/ZPL");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE0NTAiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNjcxOTY0MywiZXhwIjoxNjM2ODA2MDQzLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.k8NzkdGzaNnZ3YrueZpnhvIoX-s6yrnRVkWo7D7SnqE");
request.AddHeader("Content-Type", "application/json");
var body = @"{
" + "\n" +
@" ""Service"":{
" + "\n" +
@" ""ServiceTypeId"":93,
" + "\n" +
@" ""MustDeliverAtKiosStore"":false,
" + "\n" +
@" ""KiosStoreCode"":null,
" + "\n" +
@" ""ServiceFlow"":0,
" + "\n" +
@" ""ClientReference"":null,
" + "\n" +
@" ""ClientBarCode"":null,
" + "\n" +
@" ""PinCode"":null,
" + "\n" +
@" ""NumberOfVolumes"":2,
" + "\n" +
@" ""TotalWeightOfVolumes"":25,
" + "\n" +
@" ""Amount"":null,
" + "\n" +
@" ""Pod"":false,
" + "\n" +
@" ""Sms"":false,
" + "\n" +
@" ""Instructions"":null,
" + "\n" +
@" ""DeliveryDate"":null,
" + "\n" +
@" ""PickingDate"":null,
" + "\n" +
@" ""PreferentialPeriodOfDelivery"":null,
" + "\n" +
@" ""SenderClientCode"":null,
" + "\n" +
@" ""SenderName"":""Envio de testes"",
" + "\n" +
@" ""SenderContactName"":""Envio de testes"",
" + "\n" +
@" ""SenderContactPhoneNumber"":""960000000"",
" + "\n" +
@" ""SenderContactEmail"":""testes@vasp.pt"",
" + "\n" +
@" ""SenderAddressStreet"":""Rua Alto do Monte, nr 3"",
" + "\n" +
@" ""SenderAddressDoorNumber"":null,
" + "\n" +
@" ""SenderAddressFloor"":null,
" + "\n" +
@" ""SenderAddressPlace"":""Lisboa"",
" + "\n" +
@" ""SenderAddressPostalCode"":""1000-123"",
" + "\n" +
@" ""SenderAddressPostalCodePlace"":""Lisboa"",
" + "\n" +
@" ""SenderAddressCountryCode"":""PT"",
" + "\n" +
@" ""ReceiverClientCode"":null,
" + "\n" +
@" ""ReceiverName"":""Recepção de testes"",
" + "\n" +
@" ""ReceiverContactName"":""Recepção de testes"",
" + "\n" +
@" ""ReceiverContactPhoneNumber"":""960000000"",
" + "\n" +
@" ""ReceiverContactEmail"":null,
" + "\n" +
@" ""ReceiverAddressStreet"":""Av do Lago, nr 5"",
" + "\n" +
@" ""ReceiverAddressDoorNumber"":null,
" + "\n" +
@" ""ReceiverAddressFloor"":null,
" + "\n" +
@" ""ReceiverAddressPlace"":""Porto"",
" + "\n" +
@" ""ReceiverAddressPostalCode"":""4000-123"",
" + "\n" +
@" ""ReceiverAddressPostalCodePlace"":""Porto"",
" + "\n" +
@" ""ReceiverAddressCountryCode"":""PT"",
" + "\n" +
@" ""ReceiverFixedInstructions"":null,
" + "\n" +
@" ""Volumes"":null,
" + "\n" +
@" ""ClientObservations1"":null,
" + "\n" +
@" ""ClientObservations2"":null
" + "\n" +
@" }
" + "\n" +
@" }
" + "\n" +
@"
" + "\n" +
@"";
request.AddParameter("application/json", body, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
```
#### Java
```java=
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://vaspapirest.vaspexpresso.pt/api/V3/Shipment/Service/Label/LabelType/ZPL")
.header("Authorization", "Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE0NTAiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNjcxOTY0MywiZXhwIjoxNjM2ODA2MDQzLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.k8NzkdGzaNnZ3YrueZpnhvIoX-s6yrnRVkWo7D7SnqE")
.header("Content-Type", "application/json")
.body("{\r\n \"Service\":{\r\n \"ServiceTypeId\":93,\r\n \"MustDeliverAtKiosStore\":false,\r\n \"KiosStoreCode\":null,\r\n \"ServiceFlow\":0,\r\n \"ClientReference\":null,\r\n \"ClientBarCode\":null,\r\n \"PinCode\":null,\r\n \"NumberOfVolumes\":2,\r\n \"TotalWeightOfVolumes\":25,\r\n \"Amount\":null,\r\n \"Pod\":false,\r\n \"Sms\":false,\r\n \"Instructions\":null,\r\n \"DeliveryDate\":null,\r\n \"PickingDate\":null,\r\n \"PreferentialPeriodOfDelivery\":null,\r\n \"SenderClientCode\":null,\r\n \"SenderName\":\"Envio de testes\",\r\n \"SenderContactName\":\"Envio de testes\",\r\n \"SenderContactPhoneNumber\":\"960000000\",\r\n \"SenderContactEmail\":\"testes@vasp.pt\",\r\n \"SenderAddressStreet\":\"Rua Alto do Monte, nr 3\",\r\n \"SenderAddressDoorNumber\":null,\r\n \"SenderAddressFloor\":null,\r\n \"SenderAddressPlace\":\"Lisboa\",\r\n \"SenderAddressPostalCode\":\"1000-123\",\r\n \"SenderAddressPostalCodePlace\":\"Lisboa\",\r\n \"SenderAddressCountryCode\":\"PT\",\r\n \"ReceiverClientCode\":null,\r\n \"ReceiverName\":\"Recepção de testes\",\r\n \"ReceiverContactName\":\"Recepção de testes\",\r\n \"ReceiverContactPhoneNumber\":\"960000000\",\r\n \"ReceiverContactEmail\":null,\r\n \"ReceiverAddressStreet\":\"Av do Lago, nr 5\",\r\n \"ReceiverAddressDoorNumber\":null,\r\n \"ReceiverAddressFloor\":null,\r\n \"ReceiverAddressPlace\":\"Porto\",\r\n \"ReceiverAddressPostalCode\":\"4000-123\",\r\n \"ReceiverAddressPostalCodePlace\":\"Porto\",\r\n \"ReceiverAddressCountryCode\":\"PT\",\r\n \"ReceiverFixedInstructions\":null,\r\n \"Volumes\":null,\r\n \"ClientObservations1\":null,\r\n \"ClientObservations2\":null\r\n }\r\n }\r\n\r\n")
.asString();
```
#### Javascript
```javascript=
var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE0NTAiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNjcxOTY0MywiZXhwIjoxNjM2ODA2MDQzLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.k8NzkdGzaNnZ3YrueZpnhvIoX-s6yrnRVkWo7D7SnqE");
myHeaders.append("Content-Type", "application/json");
var raw = JSON.stringify({
"Service": {
"ServiceTypeId": 93,
"MustDeliverAtKiosStore": false,
"KiosStoreCode": null,
"ServiceFlow": 0,
"ClientReference": null,
"ClientBarCode": null,
"PinCode": null,
"NumberOfVolumes": 2,
"TotalWeightOfVolumes": 25,
"Amount": null,
"Pod": false,
"Sms": false,
"Instructions": null,
"DeliveryDate": null,
"PickingDate": null,
"PreferentialPeriodOfDelivery": null,
"SenderClientCode": null,
"SenderName": "Envio de testes",
"SenderContactName": "Envio de testes",
"SenderContactPhoneNumber": "960000000",
"SenderContactEmail": "testes@vasp.pt",
"SenderAddressStreet": "Rua Alto do Monte, nr 3",
"SenderAddressDoorNumber": null,
"SenderAddressFloor": null,
"SenderAddressPlace": "Lisboa",
"SenderAddressPostalCode": "1000-123",
"SenderAddressPostalCodePlace": "Lisboa",
"SenderAddressCountryCode": "PT",
"ReceiverClientCode": null,
"ReceiverName": "Recepção de testes",
"ReceiverContactName": "Recepção de testes",
"ReceiverContactPhoneNumber": "960000000",
"ReceiverContactEmail": null,
"ReceiverAddressStreet": "Av do Lago, nr 5",
"ReceiverAddressDoorNumber": null,
"ReceiverAddressFloor": null,
"ReceiverAddressPlace": "Porto",
"ReceiverAddressPostalCode": "4000-123",
"ReceiverAddressPostalCodePlace": "Porto",
"ReceiverAddressCountryCode": "PT",
"ReceiverFixedInstructions": null,
"Volumes": null,
"ClientObservations1": null,
"ClientObservations2": null
}
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://vaspapirest.vaspexpresso.pt/api/V3/Shipment/Service/Label/LabelType/ZPL", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
```
#### PHP
```php=
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://vaspapirest.vaspexpresso.pt/api/V3/Shipment/Service/Label/LabelType/ZPL',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"Service":{
"ServiceTypeId":93,
"MustDeliverAtKiosStore":false,
"KiosStoreCode":null,
"ServiceFlow":0,
"ClientReference":null,
"ClientBarCode":null,
"PinCode":null,
"NumberOfVolumes":2,
"TotalWeightOfVolumes":25,
"Amount":null,
"Pod":false,
"Sms":false,
"Instructions":null,
"DeliveryDate":null,
"PickingDate":null,
"PreferentialPeriodOfDelivery":null,
"SenderClientCode":null,
"SenderName":"Envio de testes",
"SenderContactName":"Envio de testes",
"SenderContactPhoneNumber":"960000000",
"SenderContactEmail":"testes@vasp.pt",
"SenderAddressStreet":"Rua Alto do Monte, nr 3",
"SenderAddressDoorNumber":null,
"SenderAddressFloor":null,
"SenderAddressPlace":"Lisboa",
"SenderAddressPostalCode":"1000-123",
"SenderAddressPostalCodePlace":"Lisboa",
"SenderAddressCountryCode":"PT",
"ReceiverClientCode":null,
"ReceiverName":"Recepção de testes",
"ReceiverContactName":"Recepção de testes",
"ReceiverContactPhoneNumber":"960000000",
"ReceiverContactEmail":null,
"ReceiverAddressStreet":"Av do Lago, nr 5",
"ReceiverAddressDoorNumber":null,
"ReceiverAddressFloor":null,
"ReceiverAddressPlace":"Porto",
"ReceiverAddressPostalCode":"4000-123",
"ReceiverAddressPostalCodePlace":"Porto",
"ReceiverAddressCountryCode":"PT",
"ReceiverFixedInstructions":null,
"Volumes":null,
"ClientObservations1":null,
"ClientObservations2":null
}
}
',
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjE0NTAiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjpbInRlc3RlQHZhc3AucHQiLCJ0ZXN0ZUB2YXNwLnB0Il0sImh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vYWNjZXNzY29udHJvbHNlcnZpY2UvMjAxMC8wNy9jbGFpbXMvaWRlbnRpdHlwcm92aWRlciI6IkFTUC5ORVQgSWRlbnRpdHkiLCJBc3BOZXQuSWRlbnRpdHkuU2VjdXJpdHlTdGFtcCI6IjdjMTRhZGQwLWZhZDEtNDkyYi1iMWFkLTFlN2JkODZiZDY3NyIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6InRlc3RlQHZhc3AucHQiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL3JvbGUiOiJQUk9EIiwiaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvd3MvMjAwNS8wNS9pZGVudGl0eS9jbGFpbXMvbW9iaWxlcGhvbmUiOiI5NjAwMDAwMDAiLCJjbGllbnRfaWQiOiIxNyIsIm5iZiI6MTYzNjcxOTY0MywiZXhwIjoxNjM2ODA2MDQzLCJpc3MiOiJodHRwczovL3Zhc3BhcGlyZXN0LnZhc3BleHByZXNzby5wdCIsImF1ZCI6IjhFcHlVNVIzNUV4YzdWQld1OXdkS3JuWXRMVjlOOE4yIn0.k8NzkdGzaNnZ3YrueZpnhvIoX-s6yrnRVkWo7D7SnqE',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
```
[Continua no documento seguinte ->](https://hackmd.io/@dsi-vasp/APIVaspExpressoParte3)