# Entregas

É a unidade central dentro do Shippify. Consiste em um conjunto de dois pontos, um de coleta e outro de entrega, onde os pacotes associados devem ser transportados.

<figure><img src="https://content.gitbook.com/content/jbJJZSH0SNa9XPAG48Gc/blobs/0s0NXI52Emi8EmoIjuKp/image.png" alt=""><figcaption><p>Entrega</p></figcaption></figure>

## Componentes

Uma tarefa tem três componentes essenciais:

* **Dados de coleta**: Consiste em duas partes, a informação de contato e uma localização. É a informação visível para o motorista ao coletar os pacotes.
* **Dados de entrega**: Consiste em duas partes, a informação de contato e a localização. É a informação visível para o motorista no momento da entrega dos pacotes.
* **Pacotes**: Contém a informação do(s) objeto(s) a ser(em) transportado(s) em uma tarefa.

Além desses, pode-se adicionar mais informações relevantes:

* **Etiquetas digitais**: Aqui você pode adicionar quantas quiser, são palavras que descrevem sua entrega, por exemplo, frágil.
* **Identificador de referência**: É o identificador do seu pedido no sistema externo que você utiliza.
* **Dados extras**: Aqui você pode guardar as informações extras que precisar, por exemplo, número da fatura, número da guia de transporte, código do cliente, etc.
* **Cod**: Valor do pagamento no ato da entrega.

## Tipo de entregas e horários de agendamento

Existem 3 tipos de entregas que você pode criar. Conforme o tipo escolhido, haverá diferentes preços e horários de coleta e entrega.

### Flex <a href="#flex" id="flex"></a>

Este tipo de tarifa divide o dia em duas partes por um horário limite:

* Quando uma entrega é criada antes do horário limite.
* Quando uma entrega é criada após o horário limite.

Para ambos os casos, podem ser feitas diferentes configurações em relação ao dia e à hora em que a entrega será programada. As mais populares são:

**Flex same day**

* Quando uma entrega é criada antes do horário limite, é programada para o mesmo dia.
* Quando uma entrega é criada após o horário limite, é programada para o próximo dia útil.

**Flex next day**

* Quando uma entrega é criada antes do horário limite, é programada para o dia útil seguinte.
* Quando se cria uma entrega após o horário limite, é programada para o dia útil subsequente.

### Express <a href="#express" id="express"></a>

Este tipo de tarifa fixa a hora de coleta mais cedo possível, e só pode ser escolhida e configurada para horários específicos.

### Regular <a href="#regular" id="regular"></a>

Este tipo de tarifa proporciona ao usuário várias janelas de tempo entre as quais ele pode escolher uma para criar sua entrega. Também é possível fornecer uma data/hora à escolha do usuário.

## Endpoints

* [Criação de entregas](https://docs.shippify.co/developers/pt/shippify-api/entregas/criacao-de-entregas)
* [Cotação de entregas ](https://docs.shippify.co/developers/pt/shippify-api/entregas/cotacao-de-entregas)
* [Obter informação de uma entrega ](https://docs.shippify.co/developers/pt/shippify-api/entregas/obter-informacao-de-uma-entrega)
* [Modificar dados de coleta de uma entrega](https://docs.shippify.co/developers/pt/shippify-api/entregas/modificar-coleta)
* [Modificar dados de uma entrega ](https://docs.shippify.co/developers/pt/shippify-api/entregas/modificar-entrega)
* [Alterar estados de entrega](https://docs.shippify.co/developers/pt/shippify-api/entregas/alterar-estados-de-entrega)
* [Atrelar condutor](https://docs.shippify.co/developers/pt/shippify-api/entregas/atrelar-motorista)
* [Imprimir etiquetas da entrega](https://docs.shippify.co/developers/pt/shippify-api/entregas/imprimir-etiquetas-da-entrega)
* [Obter link de rastreamento](https://docs.shippify.co/developers/pt/shippify-api/entregas/obter-link-de-rastreamento)
* [Anexar documentos de uma entrega](https://docs.shippify.co/developers/pt/shippify-api/entregas/anexar-documentos-a-entrega)
