AutenticaĆ§Ć£o
Seja mais sobre a autenticaĆ§Ć£o em DocumentaĆ§Ć£o API AutenticaĆ§Ć£o
CriaĆ§Ć£o do Carrinho
Para utilizaĆ§Ć£o da Webhook de criaĆ§Ć£o do carrinho serĆ” necessĆ”rio fazer uma requisiĆ§Ć£o POST para a seguinte url:
POST <https://api.newtail.com.br/webhook/shopping-cart>
No body da requisiĆ§Ć£o do webhook, deve-se mandar:
- IdentificaĆ§Ć£o da loja
- IdentificaĆ§Ć£o do cliente
- Lista de itens
Exemplo:
{
"store_id": "123",
"products_message": "1 arroz namorado\\n4 laranjas\\n1 farinha trigo veneranda\\n8 coca cola 2l\\nbombom amor carioca",
"items": [
{
"external_id": "id da oferta",
"quantity": 999.99
}
],
"shipping_type": "pick_up_in_store|shipping_from_store",
"address": {
"address_street": "Avenida Paulista",
"address_number": "123",
"address_neighborhood": "bairro",
"address_postal_code": "01310915",
"address_complement": "bloco 2",
"address_city": "SĆ£o Paulo",
"address_state": "SP",
"address_country": "Brasil",
},
"customer": {
"name": "JoĆ£o",
"document": {
"social_id": "12345678910",
"type": "cpf"
},
"date_of_birth": "2000-01-01",
"main_phone": "5521999999999",
"main_email": "string"
}
}
Obs:
- Os seguintes campos do cliente sĆ£o obrigatĆ³rios:
name
,document
emain_phone
. - A lista de itens deve ser um texto com os produtos separados por
**\\n**
- Os atributos
products_message
ouitems
sĆ£o condicionais. devem ser enviados. um ou outro. caso sejam enviados os dois. apenas o campoitems
serĆ” considerado. pick_up_in_store
retirada na loja;shipping_from_store
entrega em domicilio. Se o tipo forshipping_from_store
entĆ£o o endereƧo de entrega Ć© obrigatĆ³rio.
O retorno da requisiĆ§Ć£o terĆ” cĆ³digo HTTP 201 quando o carrinho for criado com sucesso. Em caso de erro serĆ” enviado um HTTP 5XX, com o possĆvel problema.
{
"cart_id": "8aeea7ce-e92c-416a-b73c-0caf741c3b42",
"cart_url": "<https://cart.newtail.com.br/cart_id>", // esse campo Ć© opcional.
"sla": 1440 // em minutos. esse campo Ć© opcional,
"sla_date": "iso8601", // data em formato iso 8601 compatĆvel com o sla em UTC. presente somente quando o sla estiver disponĆvel
}
Se o campo
cart_url
nĆ£o estiver presente na resposta, o link nĆ£o deve ser enviado automaticamente para o cliente, pois o carrinho passarĆ” por uma revisĆ£o manual antes de ser disponibilizado.
ComentƔrios
0 comentƔrio
Por favor, entre para comentar.