Download OpenAPI specification:Download
Esta é a especificação do Delivery Direto Admin API, que é referente às operações no painel do administrativo das lojas do Delivery Direto.
Notas gerais:
Todos os Endpoints requerem o uso de um ID do Delivery Direto. Esse ID identifica unicamente uma loja e deve ser passado pelos Headers.
Todas as integrações criadas a partir de 01/12/2021 devem enviar o Header X-DeliveryDireto-Client-Id em todas
as requisições, contendo o client_id utilizado pela integração. Integrações criadas antes dessa data tem até o dia
01/02/2022 para se adaptar.
| offset | integer >= 0 Default: 0 Posição inicial do objeto a ser retornado. |
| limit | integer <= 100 Default: 30 Quantidade de objetos a ser retornado. |
{- "status": "success",
- "data": {
- "administrators": [
- {
- "id": 1234,
- "administratorsId": 123,
- "firstName": "João",
- "lastName": "da Silva",
- "email": "joaodasilva@mailinator.com",
- "mobilePhone": "11911111111",
- "document": "12345678912",
- "level": "COMMON",
- "hasPermissionToEditOrder": true,
- "hasPermissionToDeleteOrder": true
}
], - "pagination": {
- "currentOffset": 10,
- "limit": 10,
- "totalItems": 50
}
}
}Dados do administrador
| firstName required | string |
| lastName required | string |
| email required | string |
| mobilePhone | string or null |
| document | string or null |
| level required | string |
| hasPermissionToEditOrder required | boolean |
| hasPermissionToDeleteOrder required | boolean |
{- "firstName": "João",
- "lastName": "da Silva",
- "email": "joaodasilva@mailinator.com",
- "mobilePhone": "11911111111",
- "document": "12345678912",
- "level": "COMMON",
- "hasPermissionToEditOrder": true,
- "hasPermissionToDeleteOrder": true
}{- "status": "success",
- "data": {
- "id": 1234,
- "administratorsId": 123,
- "firstName": "João",
- "lastName": "da Silva",
- "email": "joaodasilva@mailinator.com",
- "mobilePhone": "11911111111",
- "document": "12345678912",
- "level": "COMMON",
- "hasPermissionToEditOrder": true,
- "hasPermissionToDeleteOrder": true
}
}| id required | integer Identificador do administrador ou operador |
Dados do administrador ou operador
| hasPermissionToEditOrder | boolean or null Default: true Pode editar um pedido? |
| hasPermissionToDeleteOrder | boolean or null Default: true Pode apagar um pedido? |
| firstName | string or null O primeiro nome do administrador ou operador. |
| lastName | string or null O sobrenome do administrador ou operador. |
string or null O e-mail do administrador ou operador. | |
| password | string or null Senha do administrador ou operador. |
{- "hasPermissionToEditOrder": true,
- "hasPermissionToDeleteOrder": true,
- "firstName": "João",
- "lastName": "da Silva",
- "email": "joaodasilva@mailinator.com",
- "password": "senha123"
}{- "status": "success",
- "data": {
- "id": 1234,
- "administratorsId": 123,
- "firstName": "João",
- "lastName": "da Silva",
- "email": "joaodasilva@mailinator.com",
- "mobilePhone": "11911111111",
- "document": "12345678912",
- "level": "COMMON",
- "hasPermissionToEditOrder": true,
- "hasPermissionToDeleteOrder": true
}
}| id required | integer Identificador do operador |
{- "status": "fail",
- "errors": [
- {
- "field": "name",
- "message": "O campo name deve estar preenchido"
}
]
}{- "status": "success",
- "data": {
- "id": 1234,
- "administratorsId": 123,
- "firstName": "João",
- "lastName": "da Silva",
- "email": "joaodasilva@mailinator.com",
- "mobilePhone": "11911111111",
- "document": "12345678912",
- "level": "COMMON",
- "hasPermissionToEditOrder": true,
- "hasPermissionToDeleteOrder": true
}
}{- "status": "success",
- "data": {
- "totpProvisioningUri": "otpauth://totp/Example:alice@example.com?secret=AAAABBBBCCCC&issuer=Example"
}
}Dados usados para confirmar o cadastro do fator
| confirmationTotpCode required | string O código gerado pelo aplicativo autenticador. |
{- "confirmationTotpCode": "123456"
}{- "status": "success"
}{- "status": "success",
- "data": {
- "banners": [
- {
- "id": 123,
- "storeId": 123,
- "name": "Promoção black friday",
- "platforms": [
- "WEB"
], - "status": "ACTIVE",
- "type": "EXTERNAL_URL",
- "viewOrder": 1,
- "availabilities": [
- {
- "id": 123,
- "periodStart": "09:00:00-03:00",
- "periodEnd": "09:00:00-03:00",
- "weekday": 3
}
]
}
]
}
}Informações do novo banner
| name required | string Nome do banner |
| photoUrl required | string or null URL da imagem do banner |
| platforms | Array of strings Items Enum: "WEB" "ANDROID" "IOS" Plataformas no qual o banner está habilidado para ser exibido |
| status | string Default: "ACTIVE" Enum: "ACTIVE" "INACTIVE" Status do banner |
| type | string Enum: "EXTERNAL_URL" "ITEM" "CATEGORY" "LOYALTY_PROGRAM" "MEMBER_GET_MEMBER" "REWARDS" "VOUCHER" Tipo de banner |
| viewOrder | integer Posição do banner utilizado para ordenação |
ExternalUrlBannerDataDTO (object) or ItemBannerDataDTO (object) or CategoryBannerDataDTO (object) or LoyaltyProgramBannerDataDTO (object) or MemberGetMemberBannerDataDTO (object) or RewardsBannerDataDTO (object) or VoucherBannerDataDTO (object) Dados extras de acordo com o tipo de banner | |
Array of objects (BannerAvailabilityDTO) Horários que o banner fica disponível |
{- "name": "Promoção black friday",
- "platforms": [
- "WEB"
], - "status": "ACTIVE",
- "type": "EXTERNAL_URL",
- "viewOrder": 1,
- "availabilities": [
- {
- "periodStart": "09:00:00-03:00",
- "periodEnd": "09:00:00-03:00",
- "weekday": 3
}
]
}{- "status": "success",
- "data": {
- "id": 123,
- "storeId": 123,
- "name": "Promoção black friday",
- "platforms": [
- "WEB"
], - "status": "ACTIVE",
- "type": "EXTERNAL_URL",
- "viewOrder": 1,
- "availabilities": [
- {
- "id": 123,
- "periodStart": "09:00:00-03:00",
- "periodEnd": "09:00:00-03:00",
- "weekday": 3
}
]
}
}Lista com os ids dos banners, na posição final dos banners
null{- "status": "error",
- "code": "invalid_fields",
- "message": "Preencha os campos corretamente!"
}| id required | integer <int64> Identificador do banner |
Informações novas do banner
| name required | string Nome do banner |
| photoUrl required | string or null URL da imagem do banner |
| platforms | Array of strings Items Enum: "WEB" "ANDROID" "IOS" Plataformas no qual o banner está habilidado para ser exibido |
| status | string Default: "ACTIVE" Enum: "ACTIVE" "INACTIVE" Status do banner |
| type | string Enum: "EXTERNAL_URL" "ITEM" "CATEGORY" "LOYALTY_PROGRAM" "MEMBER_GET_MEMBER" "REWARDS" "VOUCHER" Tipo de banner |
| viewOrder | integer Posição do banner utilizado para ordenação |
ExternalUrlBannerDataDTO (object) or ItemBannerDataDTO (object) or CategoryBannerDataDTO (object) or LoyaltyProgramBannerDataDTO (object) or MemberGetMemberBannerDataDTO (object) or RewardsBannerDataDTO (object) or VoucherBannerDataDTO (object) Dados extras de acordo com o tipo de banner | |
Array of objects (BannerAvailabilityDTO) Horários que o banner fica disponível |
{- "name": "Promoção black friday",
- "platforms": [
- "WEB"
], - "status": "ACTIVE",
- "type": "EXTERNAL_URL",
- "viewOrder": 1,
- "availabilities": [
- {
- "periodStart": "09:00:00-03:00",
- "periodEnd": "09:00:00-03:00",
- "weekday": 3
}
]
}{- "status": "success",
- "data": {
- "id": 123,
- "storeId": 123,
- "name": "Promoção black friday",
- "platforms": [
- "WEB"
], - "status": "ACTIVE",
- "type": "EXTERNAL_URL",
- "viewOrder": 1,
- "availabilities": [
- {
- "id": 123,
- "periodStart": "09:00:00-03:00",
- "periodEnd": "09:00:00-03:00",
- "weekday": 3
}
]
}
}| file required | string <file> Arquivo a ser enviado |
{- "status": "success",
- "data": "string"
}Dados do horário de funcionamento
required | Array of objects (CreateBusinessHourDTO) Lista de horários de funcionamento | ||||||
Array
| |||||||
{- "businessHours": [
- {
- "shiftStart": "09:00:00-03:00",
- "shiftEnd": "09:00:00-03:00",
- "weekday": 3
}
]
}{- "status": "success",
- "data": {
- "businessHours": [
- {
- "id": 1234,
- "storesId": 1000,
- "shiftStart": "09:00:00-03:00",
- "shiftEnd": "09:00:00-03:00",
- "weekday": 3
}
]
}
}| id required | integer Identificador desse horário de operação. |
Dados do horário de funcionamento
required | ISO8601Time (string) Horário inicial de operação. |
required | ISO8601Time (string) Horário final de operação. |
| weekday required | integer [ 1 .. 7 ] Dia da semana desse horário de operação. Onde 1 representa o domingo e 7 o sábado. |
{- "shiftStart": "09:00:00-03:00",
- "shiftEnd": "09:00:00-03:00",
- "weekday": 3
}{- "status": "success",
- "data": {
- "id": 1234,
- "storesId": 1000,
- "shiftStart": "09:00:00-03:00",
- "shiftEnd": "09:00:00-03:00",
- "weekday": 3
}
}| id required | integer Identificador desse horário de operação. |
| force | boolean Força a exclusão do horário de funcionamento |
{- "status": "fail",
- "errors": [
- {
- "field": "name",
- "message": "O campo name deve estar preenchido"
}
]
}{- "status": "success",
- "data": {
- "timezone": "string",
- "acceptScheduledOrders": true,
- "onlyScheduledOrders": true,
- "maxDaysToSchedule": 0,
- "advanceValueScheduledOrders": 0,
- "advanceTypeScheduledOrders": "string",
- "alertEmailScheduledOrders": true
}
}Configurações do horário de funcionamento da loja a ser modificadas
| timezone | string or null |
| acceptScheduledOrders | boolean or null |
| onlyScheduledOrders | boolean or null |
| maxDaysToSchedule | integer or null |
| advanceValueScheduledOrders | integer or null |
| advanceTypeScheduledOrders | string or null |
| alertEmailScheduledOrders | boolean or null |
{- "timezone": "string",
- "acceptScheduledOrders": true,
- "onlyScheduledOrders": true,
- "maxDaysToSchedule": 0,
- "advanceValueScheduledOrders": 0,
- "advanceTypeScheduledOrders": "string",
- "alertEmailScheduledOrders": true
}{- "status": "success",
- "data": {
- "timezone": "string",
- "acceptScheduledOrders": true,
- "onlyScheduledOrders": true,
- "maxDaysToSchedule": 0,
- "advanceValueScheduledOrders": 0,
- "advanceTypeScheduledOrders": "string",
- "alertEmailScheduledOrders": true
}
}| id | integer Id da categoria. |
| name | string Nome da categoria. |
| offset | integer >= 0 Default: 0 Posição inicial do objeto a ser retornado. |
| limit | integer <= 200 Default: 30 Quantidade de objetos a ser retornado. |
{- "status": "success",
- "data": {
- "categories": [
- {
- "id": 123,
- "isPizzaModule": true,
- "status": "ACTIVE",
- "totalItems": 1234,
- "showOnMobile": true,
- "hiddenWhenUnavailable": true,
- "showOnlyImage": true,
- "name": "Bebidas",
- "description": "Bebidas diversas não alcoólicas",
- "viewOrder": 0
}
], - "pagination": {
- "currentOffset": 10,
- "limit": 10,
- "totalItems": 50
}
}
}| status | string or null Enum: "ACTIVE" "DELETED" Status da categoria |
| showOnMobile | boolean or null |
| hiddenWhenUnavailable | boolean or null |
| showOnlyImage | boolean or null |
| name required | string |
| description required | string |
| viewOrder required | integer |
{- "status": "ACTIVE",
- "showOnMobile": true,
- "hiddenWhenUnavailable": true,
- "showOnlyImage": true,
- "name": "Bebidas",
- "description": "Bebidas diversas não alcoólicas",
- "viewOrder": 0
}{- "status": "success",
- "data": {
- "id": 123,
- "isPizzaModule": true,
- "status": "ACTIVE",
- "totalItems": 1234,
- "showOnMobile": true,
- "hiddenWhenUnavailable": true,
- "showOnlyImage": true,
- "name": "Bebidas",
- "description": "Bebidas diversas não alcoólicas",
- "viewOrder": 0
}
}| categoryId required | integer ID da categoria. |
| showOnMobile | boolean or null |
| hiddenWhenUnavailable | boolean or null |
| showOnlyImage | boolean or null |
| status | string or null |
| name | string or null Nome da categoria |
| description | string or null Descrição da categoria |
| viewOrder | integer or null Ordem de listagem da categoria |
{- "showOnMobile": true,
- "hiddenWhenUnavailable": true,
- "showOnlyImage": true,
- "status": "string",
- "name": "Bebidas",
- "description": "Bebidas diversas não alcoólicas",
- "viewOrder": 0
}{- "status": "success",
- "data": {
- "id": 123,
- "isPizzaModule": true,
- "status": "ACTIVE",
- "totalItems": 1234,
- "showOnMobile": true,
- "hiddenWhenUnavailable": true,
- "showOnlyImage": true,
- "name": "Bebidas",
- "description": "Bebidas diversas não alcoólicas",
- "viewOrder": 0
}
}| categoryId required | integer ID da categoria. |
| file required | string <file> Arquivo a ser enviado |
{- "status": "success",
- "data": {
- "id": 123,
- "isPizzaModule": true,
- "status": "ACTIVE",
- "totalItems": 1234,
- "showOnMobile": true,
- "hiddenWhenUnavailable": true,
- "showOnlyImage": true,
- "name": "Bebidas",
- "description": "Bebidas diversas não alcoólicas",
- "viewOrder": 0
}
}| categoryId required | integer ID da categoria. |
{- "status": "success",
- "data": {
- "categoryAvailabilities": [
- {
- "id": 123,
- "periodStart": "09:00:00-03:00",
- "periodEnd": "09:00:00-03:00",
- "weekday": 3
}
]
}
}| categoryId required | integer ID da categoria. |
Dados da disponilibidade da categoria a ser adicionado
required | ISO8601Time (string) Horário inicial no qual a categoria fica disponível no formato HH:mm. Ex: 14:34. |
required | ISO8601Time (string) Horário final no qual a categoria fica disponível no formato HH:mm. Ex: 14:34. |
| weekday required | integer |
{- "periodStart": "09:00:00-03:00",
- "periodEnd": "09:00:00-03:00",
- "weekday": 3
}{- "status": "success",
- "data": {
- "id": 123,
- "periodStart": "09:00:00-03:00",
- "periodEnd": "09:00:00-03:00",
- "weekday": 3
}
}| categoryId required | integer ID da categoria. |
| id required | integer ID do período a ser excluído. |
{- "status": "error",
- "code": "invalid_fields",
- "message": "Preencha os campos corretamente!"
}| categoryId required | integer ID da categoria. |
Dados da disponilibidades da categoria a ser adicionado
required | Array of objects (CategoryAvailabilityDTO) Lista de disponibilidades | ||||||
Array
| |||||||
{- "categoryAvailabilities": [
- {
- "periodStart": "09:00:00-03:00",
- "periodEnd": "09:00:00-03:00",
- "weekday": 3
}
]
}{- "status": "success",
- "data": {
- "categoryAvailabilities": [
- {
- "id": 123,
- "periodStart": "09:00:00-03:00",
- "periodEnd": "09:00:00-03:00",
- "weekday": 3
}
]
}
}{- "status": "success",
- "data": {
- "checkoutquestions": [
- {
- "answerType": "TEXT",
- "status": "ACTIVE",
- "viewOrder": 1,
- "id": 123,
- "brandId": 123,
- "storeId": 123,
- "question": "true",
- "required": true
}
]
}
}Dados da nova pergunta
| answerType required | string Value: "TEXT" Tipo de resposta da questão |
| status required | string Enum: "ACTIVE" "INACTIVE" Status da questão |
| viewOrder required | integer Posição da pergunta utilizado para ordenação |
| id | integer or null Identificador da pergunta |
| brandId | integer or null O identificador da rede que criou a pergunta. |
| storeId | integer or null O identificador da loja que criou a pergunta. |
| question required | string Texto da pergunta |
| required required | boolean Se a questão é obrigatória de ser respondida |
{- "answerType": "TEXT",
- "status": "ACTIVE",
- "viewOrder": 1,
- "id": 123,
- "brandId": 123,
- "storeId": 123,
- "question": "true",
- "required": true
}{- "status": "success",
- "data": {
- "answerType": "TEXT",
- "status": "ACTIVE",
- "viewOrder": 1,
- "id": 123,
- "brandId": 123,
- "storeId": 123,
- "question": "true",
- "required": true
}
}| id required | integer Identificador da pergunta |
Dados da pergunta
| answerType required | string Value: "TEXT" Tipo de resposta da questão |
| status required | string Enum: "ACTIVE" "INACTIVE" Status da questão |
| viewOrder required | integer Posição da pergunta utilizado para ordenação |
| id | integer or null Identificador da pergunta |
| brandId | integer or null O identificador da rede que criou a pergunta. |
| storeId | integer or null O identificador da loja que criou a pergunta. |
| question required | string Texto da pergunta |
| required required | boolean Se a questão é obrigatória de ser respondida |
{- "answerType": "TEXT",
- "status": "ACTIVE",
- "viewOrder": 1,
- "id": 123,
- "brandId": 123,
- "storeId": 123,
- "question": "true",
- "required": true
}{- "status": "success",
- "data": {
- "answerType": "TEXT",
- "status": "ACTIVE",
- "viewOrder": 1,
- "id": 123,
- "brandId": 123,
- "storeId": 123,
- "question": "true",
- "required": true
}
}| customersId required | integer ID do cliente. |
| offset | integer >= 0 Default: 0 Posição inicial do objeto a ser retornado. |
| limit | integer <= 100 Default: 30 Quantidade de objetos a ser retornado. |
{- "status": "success",
- "data": {
- "addresses": [
- {
- "street": "Rua Drausio",
- "number": "123",
- "zipcode": "05511-010",
- "neighborhood": "Butantã",
- "city": "São Paulo",
- "state": "SP",
- "complement": "Próximo ao posto de gasolina",
- "reference_point": "Próximo à praça",
- "lat": -23.45,
- "lng": -45.67,
- "id": 123
}
], - "pagination": {
- "currentOffset": 10,
- "limit": 10,
- "totalItems": 50
}
}
}| customersId required | integer ID do cliente. |
| street required | string |
| number required | string |
| zipcode required | string |
| neighborhood required | string |
| city required | string |
| state required | string |
| complement required | string |
| reference_point | string or null |
| lat | number or null <float> A latitude do endereço sendo criado. Opcional, caso não seja informado, o endereço será geolocalizado. |
| lng | number or null <float> A longitude do endereço. Opcional, caso não seja informado, o endereço será geolocalizado. |
{- "street": "Rua Drausio",
- "number": "123",
- "zipcode": "05511-010",
- "neighborhood": "Butantã",
- "city": "São Paulo",
- "state": "SP",
- "complement": "Próximo ao posto de gasolina",
- "reference_point": "Próximo à praça",
- "lat": -23.45,
- "lng": -45.67
}{- "status": "success",
- "data": {
- "street": "Rua Drausio",
- "number": "123",
- "zipcode": "05511-010",
- "neighborhood": "Butantã",
- "city": "São Paulo",
- "state": "SP",
- "complement": "Próximo ao posto de gasolina",
- "reference_point": "Próximo à praça",
- "lat": -23.45,
- "lng": -45.67,
- "id": 123
}
}| customersId required | integer ID do cliente. |
| id required | integer ID do endereço. |
{- "status": "fail",
- "errors": [
- {
- "field": "name",
- "message": "O campo name deve estar preenchido"
}
]
}| firstName | string Primeiro nome do cliente |
| lastName | string Sobrenome do cliente |
string E-mail do cliente | |
| telephone | string Telefone do cliente |
| document | string Documento (CPF) do cliente formatado: 000.000.000-00 |
| offset | integer >= 0 Default: 0 Posição inicial do objeto a ser retornado. |
| limit | integer <= 100 Default: 30 Quantidade de objetos a ser retornado. |
{- "status": "success",
- "data": {
- "customers": [
- {
- "id": 123,
- "birthDate": "2020-01-01",
- "firstName": "João",
- "lastName": "da Silva",
- "email": "joaodasilva@mailinator.com",
- "telephone": "11911111111",
- "document": "12345678912"
}
], - "pagination": {
- "currentOffset": 10,
- "limit": 10,
- "totalItems": 50
}
}
}(ISO8601Date (string or null)) A data de nascimento do cliente no formato AAAA-MM-DD. Ex: 1984-05-30 | |
| firstName required | string O primeiro nome do cliente |
| lastName | string O sobrenome do cliente |
string O e-mail do cliente. | |
| telephone required | string O telefone do cliente sem formatação com DDD. Ex: (11) 91111-1111 => 11911111111 |
| document | string O CPF do cliente formatado. Ex: 123.123.123-12 |
{- "birthDate": "2020-01-01",
- "firstName": "João",
- "lastName": "da Silva",
- "email": "joaodasilva@mailinator.com",
- "telephone": "11911111111",
- "document": "12345678912"
}{- "status": "success",
- "data": {
- "id": 123,
- "birthDate": "2020-01-01",
- "firstName": "João",
- "lastName": "da Silva",
- "email": "joaodasilva@mailinator.com",
- "telephone": "11911111111",
- "document": "12345678912"
}
}| id required | integer ID do cliente. |
(ISO8601Date (string or null)) A data de nascimento do cliente no formato AAAA-MM-DD. Ex: 1984-05-30 | |
| firstName | string or null O primeiro nome do cliente |
| lastName | string or null O sobrenome do cliente |
string or null O e-mail do cliente. | |
| telephone | string or null O telefone do cliente sem formatação com DDD. Ex: (11) 91111-1111 => 11911111111 |
| document | string or null O CPF do cliente formatado. Ex: 123.123.123-12 |
{- "birthDate": "2020-01-01",
- "firstName": "João",
- "lastName": "da Silva",
- "email": "joaodasilva@mailinator.com",
- "telephone": "11911111111",
- "document": "12345678912"
}{- "status": "success",
- "data": {
- "id": 123,
- "birthDate": "2020-01-01",
- "firstName": "João",
- "lastName": "da Silva",
- "email": "joaodasilva@mailinator.com",
- "telephone": "11911111111",
- "document": "12345678912"
}
}| customersId required | integer ID do cliente. |
{- "status": "success",
- "data": {
- "lastOrder": "2020-01-01",
- "qtyOrders": 48,
- "npsGrade": "5",
- "lastLocationOrder": "Av. Paulista, 100 - São Paulo SP",
- "customerLoyaltyprogram": {
- "approved": 13,
- "approvedPercent": 5.3,
- "pending": 10,
- "pendingPercent": 7.3,
- "isExpired": true,
- "isRewardAvailable": true,
- "returningText": "compras realizadas",
- "numericSumSubtotalMinusDiscount": 1,
- "sumSubtotalMinusDiscount": 9.9,
- "used": 2,
- "description": "A cada 2 pedidos, ganhe 10% de desconto na próxima compra"
}
}
}| name | string Busca por nome da área de entrega |
| deliveryAreaId | integer Busca pelo identificador da área de entrega |
| type | string Enum: "CIRCLE" "POLYGON" Tipo da área de entrega. |
| offset | integer Default: 0 Posição inicial do objeto a ser retornado. |
| limit | integer <= 100 Default: 30 Quantidade de objetos a ser retornado. |
{- "status": "success",
- "data": {
- "deliveryAreas": [
- {
- "type": "POLYGON",
- "deliveryFeePricingRule": {
- "type": "FIXED",
- "dynamicPriceStart": "09:00:00-03:00",
- "dynamicPriceEnd": "09:00:00-03:00",
- "dynamicPrice": {
- "value": 1000,
- "currency": "BRL"
}, - "freeDeliveryMinimumOrder": {
- "value": 1000,
- "currency": "BRL"
}, - "freeDeliveryTimeout": "2020-01-01T09:00:00-03:00",
- "fixedPrice": {
- "value": 1000,
- "currency": "BRL"
}
}, - "id": 123,
- "minimumWaitingMinutes": 30,
- "maximumWaitingMinutes": 90,
- "inactivationPeriod": {
- "inactivationStart": "09:00:00-03:00",
- "inactivationEnd": "09:00:00-03:00"
}, - "isActive": true,
- "name": "string",
- "polygon": [
- {
- "lat": -23.45,
- "lng": -45.67
}
]
}
], - "pagination": {
- "currentOffset": 10,
- "limit": 10,
- "totalItems": 50
}
}
}Dados da área de entrega a ser criada
| type required | string or null Enum: "CIRCLE" "POLYGON" O tipo de area de entrega
|
(GeographicalPoint (object or null)) A localização do centro da área de entrega. Se o campo 'type' for 'CIRCLE', então este campo deve ser preenchido | |
required | object (Money) Uma descrição de quantidade de dinheiro |
(ISO8601Time (string or null)) O horário no qual começa a inativação da área de entrega. | |
(ISO8601Time (string or null)) O horário no qual termina a inativação da área de entrega. | |
(ISO8601Time (string or null)) Caso presente, indica o período final da aplicação da taxa dinâmica. | |
(Money (object or null)) Caso presente, indica o valor que deve ser adicionado a taxa de entrega durante o período de aplicação da taxa dinâmica. | |
| name required | string or null Nome da área de entrega |
| zipCode | string or null |
| address | string or null |
| neighborhood | string or null |
| radius | number or null <float> O raio da área de entrega, em metros. Se o campo "type" for "CIRCLE", então este campo deve ser preenchido |
(ISO8601Time (string or null)) | |
Array of objects or null (GeographicalPoint) O polígono da área, definido pela sequência de pontos geográficos que o definem. Se o campo "type" for "POLYGON", então este campo deve ser preenchido | |
| minimumWaitingMinutes required | integer O tempo mínimo de entrega dessa área, em minutos. |
| maximumWaitingMinutes required | integer O tempo máximo de entrega dessa área, em minutos. |
{- "type": "POLYGON",
- "center": {
- "lat": -23.45,
- "lng": -45.67
}, - "price": {
- "value": 1000,
- "currency": "BRL"
}, - "inactivationStart": "09:00:00-03:00",
- "inactivationEnd": "09:00:00-03:00",
- "dynamicPriceEnd": "09:00:00-03:00",
- "dynamicPrice": {
- "value": 1000,
- "currency": "BRL"
}, - "name": "string",
- "zipCode": "string",
- "address": "string",
- "neighborhood": "string",
- "radius": 100,
- "dynamicPriceStart": "09:00:00-03:00",
- "polygon": [
- {
- "lat": -23.45,
- "lng": -45.67
}
], - "minimumWaitingMinutes": 30,
- "maximumWaitingMinutes": 90
}{- "status": "success",
- "data": {
- "type": "POLYGON",
- "deliveryFeePricingRule": {
- "type": "FIXED",
- "dynamicPriceStart": "09:00:00-03:00",
- "dynamicPriceEnd": "09:00:00-03:00",
- "dynamicPrice": {
- "value": 1000,
- "currency": "BRL"
}, - "freeDeliveryMinimumOrder": {
- "value": 1000,
- "currency": "BRL"
}, - "freeDeliveryTimeout": "2020-01-01T09:00:00-03:00",
- "fixedPrice": {
- "value": 1000,
- "currency": "BRL"
}
}, - "id": 123,
- "minimumWaitingMinutes": 30,
- "maximumWaitingMinutes": 90,
- "inactivationPeriod": {
- "inactivationStart": "09:00:00-03:00",
- "inactivationEnd": "09:00:00-03:00"
}, - "isActive": true,
- "name": "string",
- "polygon": [
- {
- "lat": -23.45,
- "lng": -45.67
}
]
}
}{- "status": "success",
- "data": {
- "enablePostCheckoutEta": true,
- "freeDeliveryMinimumOrder": {
- "value": 1000,
- "currency": "BRL"
}, - "freeDeliveryTimeout": "2020-01-01T09:00:00-03:00",
- "minimumOrder": {
- "value": 1000,
- "currency": "BRL"
}, - "takeoutMinimumOrder": {
- "value": 1000,
- "currency": "BRL"
}, - "takeoutStatus": true,
- "takeoutTime": 5
}
}Configurações gerais da área de entrega a serem atualizadas
| enablePostCheckoutEta | boolean or null Default: false Exibir estimativa do tempo de espera |
(Money (object or null)) Valor minimo do pedido para ter taxa de entrega grátis. Se este valor for zero, então não há valor mínimo. | |
(ISO8601DateTime (string or null)) Data e hora que a taxa de entrega ficará zerada. Ex: até o dia 2021-04-31 15:30:00 as taxas de entrega ficarão zeradas. Após essa data, o valor da taxa de entrega voltará ao normal. Se este valor for null, este recurso será desativado. | |
(Money (object or null)) Pedido mínimo de delivery. Se este valor for null, não há valor mínimo do pedido. | |
(Money (object or null)) Valor mínimo do pedido para ser retirado. Se este valor for null, então este recurso está desativado e o valor mínimo da retirada é igual ao do delivery, acho que é legal deixar documentado isso. Para usar este recurso, o campo 'takeoutTime' deverá conter algum valor positivo maior que zero. | |
| takeoutStatus | boolean or null Default: false Habilita ou desabilita a retirada na loja |
| takeoutTime | integer or null Quantidade de minutos que o cliente poderá retirar o pedido. Ex: 5 minutos. Após 5 minutos do pedido a ser aprovado, o cliente poderá retirar o pedido. Se este valor for zerado, então este recurso está desativado |
{- "enablePostCheckoutEta": true,
- "freeDeliveryMinimumOrder": {
- "value": 1000,
- "currency": "BRL"
}, - "freeDeliveryTimeout": "2020-01-01T09:00:00-03:00",
- "minimumOrder": {
- "value": 1000,
- "currency": "BRL"
}, - "takeoutMinimumOrder": {
- "value": 1000,
- "currency": "BRL"
}, - "takeoutStatus": true,
- "takeoutTime": 5
}{- "status": "success",
- "data": {
- "enablePostCheckoutEta": true,
- "freeDeliveryMinimumOrder": {
- "value": 1000,
- "currency": "BRL"
}, - "freeDeliveryTimeout": "2020-01-01T09:00:00-03:00",
- "minimumOrder": {
- "value": 1000,
- "currency": "BRL"
}, - "takeoutMinimumOrder": {
- "value": 1000,
- "currency": "BRL"
}, - "takeoutStatus": true,
- "takeoutTime": 5
}
}| id required | integer identificador da área de entrega. |
Dados da área de entrega a ser atualizada
| type | string or null Value: "POLYGON" O tipo de area de entrega
|
required | object (Money) Uma descrição de quantidade de dinheiro |
(ISO8601Time (string or null)) O horário no qual começa a inativação da área de entrega. | |
(ISO8601Time (string or null)) |