# Envio Automático para FEMA
Source: https://ecommerce-docs.fema.pt/configuration/auto-ship

Configure quando as encomendas são enviadas automaticamente para a FEMA após chegarem ao Shopify.

## O que é

O envio automático cria a guia FEMA assim que uma encomenda chega ao Shopify, sem necessidade de intervenção manual. Pode escolher o momento em que isso acontece: imediatamente, com um atraso ou a uma hora fixa do dia.

## Onde configurar

No Shopify Admin, abra a app FEMA e clique em **Envio automático** na barra lateral.

## Modos disponíveis

| Modo                             | Comportamento                                                                                                   |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Desactivado**                  | Nenhum envio é criado automaticamente. Terá de criar manualmente pelo bloco de encomenda ou pela ação em massa. |
| **Imediato**                     | A guia FEMA é criada assim que a encomenda é recebida no Shopify.                                               |
| **Com atraso**                   | A guia é criada após um número de horas configurável (1–12 horas).                                              |
| **Hora específica (fim do dia)** | Todas as encomendas do dia são enviadas para a FEMA a uma hora fixa (em UTC).                                   |

## Como configurar

1. Selecione o **Modo** pretendido.
2. Se escolheu **Com atraso**, defina as **Horas de atraso** (mínimo 1, máximo 12).
3. Se escolheu **Hora específica**, defina a **Hora de envio (UTC)** no formato `HH:MM` (ex: `20:00`).
4. Clique em **Guardar**.

<Note>
  A hora de envio está em UTC. Converta para o seu fuso horário antes de configurar (ex: Portugal no inverno é UTC+0, no verão UTC+1).
</Note>

<Tip>
  Use o modo **Com atraso** se quiser uma janela para cancelar ou editar encomendas antes de serem enviadas para a FEMA.
</Tip>


# Credenciais FEMA
Source: https://ecommerce-docs.fema.pt/configuration/credentials

Associe a sua conta FEMA à loja Shopify.

## Onde configurar

No Shopify Admin, abra a app FEMA e clique no separador **Credenciais FEMA** na barra lateral.

<Frame>
  <img alt="Separador Credenciais FEMA" />

  <img alt="Separador Credenciais FEMA" />
</Frame>

## Campos

| Campo          | Descrição                            |
| -------------- | ------------------------------------ |
| **Utilizador** | Nome de utilizador da sua conta FEMA |
| **Password**   | Password da conta FEMA               |

<Note>
  A password é guardada de forma encriptada. Pode deixá-la em branco ao guardar se quiser apenas alterar o utilizador. A password anterior mantém-se.
</Note>

## Como configurar

1. Introduza o seu **utilizador FEMA**.
2. Introduza a **password**.
3. Clique em **Guardar**.

O badge no canto superior direito do separador indica o estado:

* **Configurado** (verde): credenciais guardadas com sucesso
* **Não configurado** (amarelo): ainda não foram inseridas credenciais

## Problemas comuns

<AccordionGroup>
  <Accordion title="Envio falha com erro de autenticação">
    Verifique se as credenciais estão corretas acedendo ao portal FEMA diretamente. Se conseguir entrar no portal mas o envio falha, as credenciais podem estar desatualizadas. Guarde-as novamente.
  </Accordion>

  <Accordion title="Não tenho credenciais FEMA">
    Contacte a FEMA em [fema.pt](https://www.fema.pt) para obter acesso ao sistema de expedições.
  </Accordion>
</AccordionGroup>


# Mapeamento de Envios
Source: https://ecommerce-docs.fema.pt/configuration/mapping

Liga os métodos de envio Shopify aos serviços FEMA e define o formato das etiquetas.

## Onde configurar

No Shopify Admin, abra a app FEMA e clique em **Mapeamento de envios** na barra lateral.

<Frame>
  <img alt="Separador Mapeamento de envios" />

  <img alt="Separador Mapeamento de envios" />
</Frame>

## Formato de etiqueta

Escolha o tamanho das etiquetas PDF geradas:

| Formato | Uso recomendado                   |
| ------- | --------------------------------- |
| **A4**  | Impressoras de secretária comuns  |
| **A6**  | Impressoras térmicas de etiquetas |

## Como configurar

1. Selecione o **Formato de etiqueta** pretendido.
2. Para cada método de envio listado, escolha o **serviço FEMA** correspondente no dropdown.
3. Clique em **Guardar**.

<Note>
  O mapeamento usa **correspondência exata** do nome do método. O nome do método na Shopify tem de ser idêntico ao configurado aqui.
</Note>

<Warning>
  Métodos com "—" (sem serviço associado) ou métodos não listados no mapeamento são **ignorados** — nenhum envio FEMA é criado automaticamente para essas encomendas. Se não houver nenhum mapeamento configurado, todas as encomendas são ignoradas.
</Warning>

<Note>
  Ao criar um envio manualmente (bloco da encomenda ou ação em massa) para um método sem mapeamento, a app mostra o aviso **"Serviço FEMA não configurado"** com indicação para voltar aqui e associar o serviço.
</Note>


# Embalagens
Source: https://ecommerce-docs.fema.pt/configuration/packages

Crie templates de caixas para usar rapidamente ao criar envios.

## Para que servem

As embalagens são templates pré-definidos de caixas ou envelopes. Quando cria um envio (individual ou em massa), pode selecionar uma embalagem em vez de inserir as dimensões manualmente.

## Onde configurar

No Shopify Admin, abra a app FEMA e clique em **Embalagens** na barra lateral.

<Frame>
  <img alt="Separador Embalagens" />
</Frame>

## Tipos de embalagem

| Tipo      | Descrição                  |
| --------- | -------------------------- |
| **Caixa** | Caixa de cartão standard   |
| **LTR**   | Envelope                   |
| **PLT**   | Palete                     |
| **Rolo**  | Embalagem cilíndrica       |
| **Saco**  | Saco de plástico ou tecido |

## Adicionar uma embalagem

1. Clique em **Adicionar**.
2. Preencha o **nome** (ex: "Caixa pequena").
3. Selecione o **tipo de embalagem**.
4. Insira as dimensões em centímetros: **comprimento**, **altura**, **largura**.
5. Clique em **Guardar**.

## Editar ou remover

* Clique em **Editar** numa embalagem para alterar as suas propriedades.
* Clique no ícone de lixo para remover.

<Warning>
  Remover uma embalagem não afeta envios já criados. Apenas deixa de estar disponível para novos envios.
</Warning>

## Sem embalagens configuradas

Se não configurar nenhuma embalagem, os envios são criados com as dimensões padrão FEMA:

| Campo       | Valor padrão |
| ----------- | ------------ |
| Tipo        | Caixa        |
| Comprimento | 20 cm        |
| Altura      | 10 cm        |
| Largura     | 2 cm         |

Para personalizar dimensões por envio, use o bloco na página da encomenda.


# Morada do Remetente
Source: https://ecommerce-docs.fema.pt/configuration/sender

Define os dados do expedidor que aparecem em todas as guias de transporte.

## Onde configurar

No Shopify Admin, abra a app FEMA e clique em **Morada de origem** na barra lateral.

<Frame>
  <img alt="Separador Morada de origem" />
</Frame>

## Campos

| Campo                | Obrigatório | Descrição                                  |
| -------------------- | ----------- | ------------------------------------------ |
| **Nome / Empresa**   | Sim         | Nome ou empresa que aparece como remetente |
| **Morada**           | Sim         | Primeira linha da morada                   |
| **Morada (linha 2)** | Não         | Complemento de morada (andar, lote, etc.)  |
| **Cidade**           | Não         | Cidade do remetente                        |
| **Código postal**    | Não         | Código postal no formato `XXXX-XXX`        |
| **País de origem**   | Não         | País de expedição (por defeito: Portugal)  |
| **Telefone**         | Não         | Número de telefone de contacto             |
| **Email**            | Não         | Email de contacto                          |

## Como configurar

1. Preencha pelo menos o **Nome / Empresa** e a **Morada**.
2. Preencha os restantes campos para garantir que as guias estão completas.
3. Clique em **Guardar**.

<Tip>
  Preencha sempre o telefone e email. Alguns serviços FEMA exigem contacto do remetente para envios internacionais.
</Tip>


# Auto-ship to FEMA
Source: https://ecommerce-docs.fema.pt/en/configuration/auto-ship

Configure when orders are automatically sent to FEMA after arriving in Shopify.

## What it is

Auto-ship creates the FEMA shipment as soon as an order arrives in Shopify, with no manual action required. You can choose when that happens: immediately, after a delay, or at a fixed time of day.

## Where to configure

In Shopify Admin, open the FEMA app and click **Auto-ship** in the sidebar.

## Available modes

| Mode                       | Behaviour                                                                                                 |
| -------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Disabled**               | No shipments are created automatically. You must create them manually via the order block or bulk action. |
| **Immediate**              | The FEMA shipment is created as soon as the order is received in Shopify.                                 |
| **Delayed**                | The shipment is created after a configurable number of hours (1–12).                                      |
| **Scheduled (end of day)** | All orders for the day are sent to FEMA at a fixed time (in UTC).                                         |

## How to configure

1. Select the desired **Mode**.
2. If you chose **Delayed**, set the **Delay (hours)** (minimum 1, maximum 12).
3. If you chose **Scheduled**, set the **Send time (UTC)** in `HH:MM` format (e.g. `20:00`).
4. Click **Save**.

<Note>
  The send time is in UTC. Convert to your timezone before configuring (e.g. Portugal in winter is UTC+0, in summer UTC+1).
</Note>

<Tip>
  Use **Delayed** mode if you want a window to cancel or edit orders before they are submitted to FEMA.
</Tip>


# FEMA Credentials
Source: https://ecommerce-docs.fema.pt/en/configuration/credentials

Link your FEMA account to your Shopify store.

## Where to configure

In Shopify Admin, open the FEMA app and click **FEMA Credentials** in the sidebar.

<Frame>
  <img alt="FEMA Credentials tab" />
</Frame>

## Fields

| Field        | Description                |
| ------------ | -------------------------- |
| **Username** | Your FEMA account username |
| **Password** | Your FEMA account password |

<Note>
  The password is stored encrypted. You can leave it blank when saving if you only want to update the username. The existing password is kept.
</Note>

## How to configure

1. Enter your **FEMA username**.
2. Enter your **password**.
3. Click **Save**.

The badge in the top-right corner of the tab shows the status:

* **Configured** (green): credentials saved successfully
* **Not configured** (yellow): no credentials entered yet

## Common issues

<AccordionGroup>
  <Accordion title="Shipment fails with an authentication error">
    Verify the credentials are correct by logging into the FEMA portal directly. If you can log in but shipments fail, the credentials may be out of date. Save them again in the app.
  </Accordion>

  <Accordion title="I don't have FEMA credentials">
    Contact FEMA at [fema.pt](https://www.fema.pt) to get access to their shipping system.
  </Accordion>
</AccordionGroup>


# Shipping Mapping
Source: https://ecommerce-docs.fema.pt/en/configuration/mapping

Link Shopify shipping methods to FEMA services and set the label format.

## Where to configure

In Shopify Admin, open the FEMA app and click **Shipping mapping** in the sidebar.

<Frame>
  <img alt="Shipping mapping tab" />
</Frame>

## Label format

Choose the size of generated PDF labels:

| Format | Recommended for           |
| ------ | ------------------------- |
| **A4** | Standard desktop printers |
| **A6** | Thermal label printers    |

## How to configure

1. Select the desired **Label format**.
2. For each listed shipping method, choose the corresponding **FEMA service** from the dropdown.
3. Click **Save**.

<Note>
  Mapping uses **exact name matching**. The Shopify method name must match exactly what is configured here — no partial or fuzzy matching.
</Note>

<Warning>
  Methods set to "—" (no service selected) or methods not listed in the mapping are **ignored** — no FEMA shipment is created automatically for those orders. If no mappings are configured at all, all orders are ignored.
</Warning>


# Packages
Source: https://ecommerce-docs.fema.pt/en/configuration/packages

Create box templates to quickly select when creating shipments.

## What they're for

Packages are pre-defined templates for boxes or envelopes. When creating a shipment (individual or bulk), you can select a package instead of entering dimensions manually each time.

## Where to configure

In Shopify Admin, open the FEMA app and click **Packages** in the sidebar.

<Frame>
  <img alt="Packages tab" />
</Frame>

## Package types

| Type      | Description            |
| --------- | ---------------------- |
| **Caixa** | Standard cardboard box |
| **LTR**   | Envelope               |
| **PLT**   | Pallet                 |
| **Rolo**  | Cylindrical packaging  |
| **Saco**  | Plastic or fabric bag  |

## Adding a package

1. Click **Add**.
2. Enter a **name** (e.g. "Small box").
3. Select the **package type**.
4. Enter dimensions in centimetres: **length**, **height**, **width**.
5. Click **Save**.

## Editing or removing

* Click **Edit** on a package to change its properties.
* Click the trash icon to remove it.

<Warning>
  Removing a package does not affect already-created shipments. It only stops being available for new ones.
</Warning>

## No packages configured

If you don't configure any packages, shipments are created with FEMA's default dimensions:

| Field  | Default value |
| ------ | ------------- |
| Type   | Caixa (Box)   |
| Length | 20 cm         |
| Height | 10 cm         |
| Width  | 2 cm          |

To customise dimensions per shipment, use the block on the individual order page.


# Sender Address
Source: https://ecommerce-docs.fema.pt/en/configuration/sender

Define the sender details that appear on all shipping labels.

## Where to configure

In Shopify Admin, open the FEMA app and click **Sender address** in the sidebar.

<Frame>
  <img alt="Sender address tab" />
</Frame>

## Fields

| Field                 | Required | Description                                |
| --------------------- | -------- | ------------------------------------------ |
| **Name / Company**    | Yes      | Name or company shown as the sender        |
| **Address**           | Yes      | First line of the address                  |
| **Address (line 2)**  | No       | Address complement (floor, building, etc.) |
| **City**              | No       | Sender's city                              |
| **Postal code**       | No       | Postal code                                |
| **Country of origin** | No       | Shipping country (default: Portugal)       |
| **Phone**             | No       | Contact phone number                       |
| **Email**             | No       | Contact email                              |

## How to configure

1. Fill in at least the **Name / Company** and **Address**.
2. Complete the remaining fields to ensure labels are fully populated.
3. Click **Save**.

<Tip>
  Always fill in phone and email. Some FEMA services require sender contact details for international shipments.
</Tip>


# Shipment Block (Admin Block)
Source: https://ecommerce-docs.fema.pt/en/extensions/admin-block

Create and track FEMA shipments directly from each order page.

## What it is

The FEMA block appears in the sidebar of each order in Shopify Admin. It lets you create a shipment, check tracking status, and print the label, all without leaving the page.

<Frame>
  <img alt="FEMA block on the order page" />
</Frame>

## Adding the block (first time)

If the block isn't visible on the order page, you need to add it once manually:

1. Open any order in Shopify Admin.
2. In the right sidebar, click the **+** button.
3. Search for **FEMA** in the list of available blocks and click to add it.

<Frame>
  <img alt="Adding the FEMA block via the + button" />
</Frame>

<Note>
  This setting is saved — you don't need to repeat it for other orders.
</Note>

## Creating a shipment

When no shipment exists for the order, the block shows:

1. **Package**: select from your configured packages (if any). If none are configured, FEMA's default dimensions are used.
2. **Volumes**: number of volumes (1 to 10).
3. Click **Create shipment**.

The app automatically fetches the delivery address from the order and creates the label in FEMA. The tracking number is added to the Shopify order.

## Viewing an existing shipment

When a shipment already exists, the block shows:

* **Tracking number**
* **Current status** (colour-coded badge)
* **Last updated** (date and time)

Click **Refresh** to query the status directly from FEMA and update the database with the latest information.

## Printing a label

1. Click **Print label**.
2. The label opens in a new tab as a PDF, ready to print.

<Note>
  If the order hasn't been marked as fulfilled in Shopify yet, the app marks it automatically when printing.
</Note>

## Possible statuses

See the full list of statuses on the [Shipment Statuses](/en/statuses) page.


# Bulk Print Labels
Source: https://ecommerce-docs.fema.pt/en/extensions/bulk-labels

Merge labels from multiple orders into a single PDF for printing.

## What it is

The **Print FEMA labels** bulk action gathers labels from multiple orders into a single PDF document, ready to print in one go.

<Frame>
  <img alt="Bulk label printing panel" />
</Frame>

## How to use

1. In Shopify Admin, go to **Orders**.
2. Select the orders whose labels you want to print.
3. Click **Actions** > **Print FEMA labels**.
4. A panel opens that checks which orders have a shipment created.

## Labels panel

The app automatically checks which selected orders have a FEMA shipment. For each order:

| Status                 | Meaning                            |
| ---------------------- | ---------------------------------- |
| **Ready** (green)      | Shipment found, label available    |
| **No shipment** (grey) | No shipment created for this order |

For orders with **Ready** status, you can:

* Click **Open** to open the individual label in a new tab.
* Click **Print all (X)** to open a single PDF with all labels combined.

## Print all

The **Print all** button generates a PDF that concatenates all ready labels. It opens in a new tab. Use the browser's print function (`Ctrl+P` / `Cmd+P`).

<Note>
  Orders without a shipment are automatically excluded from the PDF. Create the missing shipments with the **Create FEMA shipments** action before printing.
</Note>


# FEMA Shopify Integration
Source: https://ecommerce-docs.fema.pt/en/index

Create FEMA shipments directly from Shopify Admin, without leaving the platform.

## What is this app?

The FEMA Shopify integration connects your store directly to FEMA's shipping system. You can create shipping labels, print them, and track shipment status without leaving Shopify Admin.

## What you can do

<Columns>
  <Card title="Create shipments" icon="box">
    Create FEMA shipping labels for any order with one click, directly from the order page.
  </Card>

  <Card title="Bulk shipments" icon="boxes-stacked">
    Select multiple orders and create all labels at once.
  </Card>

  <Card title="Print labels" icon="print">
    Print individual labels or merge several into a single PDF.
  </Card>

  <Card title="Automatic tracking" icon="map-pin">
    Shipment status updates automatically in Shopify.
  </Card>
</Columns>

## Before you start

You need:

* An active Shopify store
* FEMA credentials (username and password), obtained directly from FEMA

<Card title="Get started" icon="rocket" href="/en/quickstart">
  Follow the quick start guide to install and create your first shipment.
</Card>


# Quick Start
Source: https://ecommerce-docs.fema.pt/en/quickstart

Set up the FEMA integration and start creating shipments in minutes.

## Step 1: FEMA credentials

Go to **Apps** > **FEMA** > **Settings** and open the **FEMA Credentials** tab.

1. Enter your FEMA **username** and **password**.
2. Click **Save**.

The badge changes from "Not configured" to "Configured" once credentials are saved.

<Frame>
  <img alt="FEMA credentials setup" />
</Frame>

<Note>
  If you don't have FEMA credentials yet, contact FEMA at [fema.pt](https://www.fema.pt) to get access.
</Note>

## Step 2: Sender address

Open the **Sender address** tab.

1. Fill in the name/company, address, city, postal code, and contact details.
2. Click **Save**.

This address appears on all shipping labels as the sender.

<Frame>
  <img alt="Sender address setup" />
</Frame>

## Step 3: Shipping mapping

Open the **Shipping mapping** tab.

Map each Shopify shipping method to the corresponding FEMA service. The app uses this mapping to determine which type of shipment to create for each order.

<Frame>
  <img alt="Shipping method mapping" />
</Frame>

<Tip>
  If you have multiple Shopify shipping methods (e.g. standard, express), create a mapping for each one.
</Tip>

## Step 4: Packages

Open the **Packages** tab.

Create templates for the boxes you regularly use. When creating a shipment, simply select the package instead of filling in dimensions and weight manually.

<Frame>
  <img alt="Package setup" />
</Frame>

***

You're all set. You can now create FEMA shipments directly from any order in Shopify Admin.

<Columns>
  <Card title="Create shipment" icon="box" href="/en/extensions/admin-block">
    Create a shipment from an individual order.
  </Card>

  <Card title="Bulk create" icon="boxes-stacked" href="/en/extensions/bulk-action">
    Process multiple orders at once.
  </Card>

  <Card title="Print labels" icon="print" href="/en/extensions/bulk-labels">
    Merge multiple labels into a single PDF.
  </Card>

  <Card title="Shipment statuses" icon="circle-info" href="/en/statuses">
    Reference for all FEMA tracking statuses.
  </Card>
</Columns>


# Shipment Statuses
Source: https://ecommerce-docs.fema.pt/en/statuses

Complete list of FEMA statuses and what they mean.

## Statuses by phase

### Awaiting pickup

| Status              | Description                         |
| ------------------- | ----------------------------------- |
| Aberta              | Label created, awaiting FEMA pickup |
| Espera Levantamento | Awaiting courier collection         |
| Espera Recolha      | Awaiting pickup                     |
| A Aguardar Recolha  | Variant of awaiting pickup          |

### Collected / In warehouse

| Status                            | Description                                 |
| --------------------------------- | ------------------------------------------- |
| Recolhida                         | Parcel collected by courier                 |
| Entrada Armazém / Entrada Armazem | Arrived at FEMA warehouse (accent variants) |
| Verificada                        | Verified in warehouse                       |
| Exportada                         | Prepared for export                         |

### In transit

| Status                                 | Description                                          |
| -------------------------------------- | ---------------------------------------------------- |
| Em Trânsito                            | In transit to destination                            |
| Em Trânsito para as Ilhas              | In transit to Azores or Madeira                      |
| Em Trânsito para as Ilhas Espanholas   | In transit to the Canary Islands or Balearic Islands |
| Em Trânsito para Plataforma de Destino | En route to local distribution hub                   |

### Out for delivery

| Status             | Description                             |
| ------------------ | --------------------------------------- |
| Em Distribuição    | Out for delivery today                  |
| 2ª Volta           | Second delivery attempt on the same day |
| Entrega Reagendada | Delivery rescheduled to another date    |

### Failed attempt

| Status                 | Description                           |
| ---------------------- | ------------------------------------- |
| Entrega Parcial        | Partial delivery (only some volumes)  |
| Excepção               | An exception occurred during delivery |
| Entrega Não Conseguida | Delivery attempt unsuccessful         |

### Final statuses: delivered

<Check>These statuses indicate successful delivery.</Check>

| Status                   | Description                                 |
| ------------------------ | ------------------------------------------- |
| **Entregue**             | Delivered to the recipient                  |
| **Levantado na Agência** | Picked up by the recipient at a FEMA branch |

### Final statuses: returned / cancelled

<Warning>These are final statuses. No further automatic updates will occur.</Warning>

| Status                          | Description                      |
| ------------------------------- | -------------------------------- |
| Devolvida / Devolvido           | Returned to sender               |
| Devolvida Ao Remetente          | Returned to sender (variant)     |
| Devolvida ao Expedidor          | Returned to shipper              |
| Rejeitada                       | Rejected by recipient            |
| Fechada                         | Shipment closed without delivery |
| Anulada / Envio Anulado         | Label cancelled                  |
| Envio Abandonado                | Shipment abandoned               |
| Destruído a Pedido do Expedidor | Destroyed at sender's request    |

## Shopify synchronisation

Each shipment's status is automatically synced to Shopify:

| FEMA Status                                                              | Shopify Event        |
| ------------------------------------------------------------------------ | -------------------- |
| Em Trânsito / Recolhida / Entrada Armazém / Entrada Armazem              | `in_transit`         |
| Em Distribuição / 2ª Volta                                               | `out_for_delivery`   |
| Entrega Parcial / Excepção / Entrega Não Conseguida / Entrega Reagendada | `attempted_delivery` |
| Entregue / Levantado na Agência                                          | `delivered`          |
| Devolvida / Rejeitada / Anulada / etc.                                   | `failure`            |


# Bloco de Envio (Admin Block)
Source: https://ecommerce-docs.fema.pt/extensions/admin-block

Crie e acompanhe envios FEMA diretamente na página de cada encomenda.

## O que é

O bloco FEMA aparece no painel lateral de cada encomenda no Shopify Admin. Permite criar o envio, ver o estado de tracking e imprimir a etiqueta sem sair da página.

<Frame>
  <img alt="Bloco FEMA na página de encomenda" />
</Frame>

## Adicionar o bloco (primeira vez)

Se o bloco não estiver visível na página da encomenda, é necessário adicioná-lo manualmente uma vez:

1. Abra qualquer encomenda no Shopify Admin.
2. No painel lateral direito, clique no botão **+**.
3. Procure **FEMA** na lista de blocos disponíveis e clique para adicionar.

<Frame>
  <img alt="Adicionar bloco FEMA via botão +" />
</Frame>

<Note>
  Esta configuração fica guardada — não é necessário repetir para outras encomendas.
</Note>

## Criar um envio

Quando ainda não existe envio para a encomenda, o bloco mostra:

1. **Embalagem**: selecione uma das embalagens configuradas (se existirem). Se não houver embalagens, usam-se as dimensões padrão FEMA.
2. **Volumes**: número de volumes (1 a 10).
3. Clique em **Criar envio**.

A app obtém automaticamente a morada de entrega da encomenda e cria a guia na FEMA. O número de tracking é adicionado à encomenda no Shopify.

## Ver estado de um envio existente

Quando já existe envio para a encomenda, o bloco mostra:

* **Número de tracking**
* **Estado atual** (badge colorido)
* **Última atualização** (data e hora)

Clique em **Atualizar** para consultar o estado diretamente na FEMA e atualizar os dados na base de dados.

## Imprimir etiqueta

1. Clique em **Imprimir etiqueta**.
2. A etiqueta abre num novo separador em PDF, pronta para imprimir.

<Note>
  Se a encomenda ainda não estiver marcada como processada no Shopify, a app marca-a automaticamente ao imprimir.
</Note>

## Estados possíveis

Consulte a lista completa de estados na página [Estados de Envio](/statuses).


# Criar Envios em Massa
Source: https://ecommerce-docs.fema.pt/extensions/bulk-action

Selecione várias encomendas e crie todas as guias FEMA de uma vez.

## O que é

A ação em massa **Criar envios FEMA** permite processar múltiplas encomendas de uma vez, em vez de criar cada guia individualmente.

<Frame>
  <img alt="Painel de criação de envios em massa" />
</Frame>

## Como usar

1. No Shopify Admin, aceda a **Encomendas**.
2. Selecione as encomendas que pretende processar (checkbox à esquerda de cada linha).
3. Clique em **Ações** > **Criar envios FEMA**.
4. Abre-se um painel com todas as encomendas selecionadas.

## Painel de criação em massa

Para cada encomenda, pode configurar:

* **Embalagem**: selecione da lista de embalagens configuradas
* **Volumes**: número de volumes para essa encomenda (1 a 9)

Encomendas que a app deteta como inválidas são marcadas automaticamente como ignoradas:

| Razão               | Comportamento                |
| ------------------- | ---------------------------- |
| Encomenda cancelada | Ignorada, não é criado envio |
| Já tem envio criado | Ignorada, não duplica        |

Clique em **Criar X envios** para processar todas as encomendas pendentes.

## Resultados

Após o processamento, cada encomenda mostra o resultado:

| Estado                 | Significado                              |
| ---------------------- | ---------------------------------------- |
| **Criado** (verde)     | Guia criada com sucesso                  |
| **Ignorado** (amarelo) | Encomenda cancelada ou já com envio      |
| **Erro** (vermelho)    | Falha ao criar. Veja a mensagem de erro. |

<Tip>
  Para criar envios de todas as encomendas do dia, filtre por data antes de selecionar. Poupa tempo a processar manualmente.
</Tip>


# Imprimir Etiquetas em Massa
Source: https://ecommerce-docs.fema.pt/extensions/bulk-labels

Junte etiquetas de várias encomendas num único PDF para impressão.

## O que é

A ação em massa **Imprimir etiquetas FEMA** reúne as etiquetas de várias encomendas num único documento PDF, pronto para imprimir de uma vez.

<Frame>
  <img alt="Painel de impressão de etiquetas em massa" />
</Frame>

## Como usar

1. No Shopify Admin, aceda a **Encomendas**.
2. Selecione as encomendas cujas etiquetas pretende imprimir.
3. Clique em **Ações** > **Imprimir etiquetas FEMA**.
4. Abre-se um painel que verifica quais as encomendas com envio criado.

## Painel de etiquetas

A app verifica automaticamente quais as encomendas selecionadas que têm envio FEMA. Para cada encomenda:

| Estado                   | Significado                              |
| ------------------------ | ---------------------------------------- |
| **Pronto** (verde)       | Envio encontrado, etiqueta disponível    |
| **Sem envio** (cinzento) | Não foi criado envio para esta encomenda |

Para encomendas com estado **Pronto**, pode:

* Clicar em **Abrir** para abrir a etiqueta individual num novo separador.
* Clicar em **Imprimir todas (X)** para abrir um PDF único com todas as etiquetas combinadas.

## Imprimir todas

O botão **Imprimir todas** gera um PDF que concatena as etiquetas de todas as encomendas prontas. Abre num novo separador. Use a função de impressão do browser (`Ctrl+P` / `Cmd+P`).

<Note>
  Encomendas sem envio são automaticamente excluídas do PDF. Crie os envios em falta com a ação **Criar envios FEMA** antes de imprimir.
</Note>


# Integração FEMA para Shopify
Source: https://ecommerce-docs.fema.pt/index

Crie envios FEMA diretamente a partir do Shopify Admin, sem sair da plataforma.

## O que é esta app?

A integração FEMA para Shopify liga a sua loja diretamente ao sistema de expedições da FEMA. Pode criar guias de transporte, imprimir etiquetas e acompanhar o estado dos envios sem sair do Shopify Admin.

## O que pode fazer

<Columns>
  <Card title="Criar envios" icon="box">
    Crie guias FEMA para qualquer encomenda com um clique, diretamente na página da encomenda.
  </Card>

  <Card title="Envios em massa" icon="boxes-stacked">
    Selecione várias encomendas e crie todas as guias de uma vez.
  </Card>

  <Card title="Imprimir etiquetas" icon="print">
    Imprima etiquetas individuais ou junte várias num único PDF.
  </Card>

  <Card title="Tracking automático" icon="map-pin">
    O estado de cada envio é atualizado automaticamente no Shopify.
  </Card>
</Columns>

## Antes de começar

É necessário ter:

* Uma loja Shopify ativa
* Credenciais FEMA (utilizador e password), obtidas junto da FEMA

<Card title="Começar a configurar" icon="rocket" href="/quickstart">
  Siga o guia de início rápido para instalar e fazer o primeiro envio.
</Card>


# Política de Privacidade
Source: https://ecommerce-docs.fema.pt/legal/privacy

Como a app Fema trata os dados dos lojistas e das encomendas.

**FEMA - Transportes Express & Logistics, S.A.**
Avenida da Primavera, 150, 4815-756, Vizela
NIF: 505613050
Email: [it@itfema.pt](mailto:it@itfema.pt)

*Última atualização: junho de 2026*

## 1. Responsável pelo tratamento

O responsável pelo tratamento dos dados pessoais recolhidos através da app Fema é a **FEMA - Transportes Express & Logistics, S.A.**, com sede na Avenida da Primavera, 150, 4815-756, Vizela, NIF 505613050.

## 2. Dados recolhidos

A app recolhe e trata os seguintes dados para prestar o serviço:

| Categoria        | Dados                                                                         |
| ---------------- | ----------------------------------------------------------------------------- |
| Loja Shopify     | Domínio, token de acesso à API                                                |
| Credenciais FEMA | Nome de utilizador e palavra-passe da conta FEMA                              |
| Encomendas       | ID da encomenda, nome e morada do destinatário, código postal, telefone, peso |
| Envios           | Número de tracking, estado de entrega, data de criação e última atualização   |

Não são recolhidos dados de pagamento, dados de navegação nem cookies.

## 3. Finalidade e base jurídica

Os dados são tratados exclusivamente para:

* Criar expedições na plataforma FEMA com base nas encomendas Shopify
* Acompanhar o estado de entrega e sincronizá-lo com a loja
* Gerar e disponibilizar etiquetas de envio

## 4. Partilha de dados

Os dados são partilhados apenas com:

* **Shopify**: plataforma de e-commerce através da qual a app opera
* **API SOAP da FEMA**: para criação e acompanhamento de envios

Não são vendidos, cedidos nem partilhados com terceiros para fins comerciais ou de marketing.

## 5. Conservação dos dados

Os dados são conservados pelo tempo necessário à prestação do serviço. Para solicitar a eliminação dos dados, contacte [it@itfema.pt](mailto:it@itfema.pt).

## 6. Direitos dos titulares

Nos termos do RGPD, o lojista tem direito a:

* Aceder aos dados tratados
* Retificar dados incorretos
* Solicitar a eliminação dos dados
* Opor-se ao tratamento
* Portabilidade dos dados

Para exercer estes direitos, contacte: **[it@itfema.pt](mailto:it@itfema.pt)**

Tem ainda o direito de apresentar reclamação à **Comissão Nacional de Proteção de Dados (CNPD)** em [www.cnpd.pt](https://www.cnpd.pt).

## 7. Segurança

Os dados são armazenados em servidores com acesso restrito e transmitidos através de ligações encriptadas (HTTPS/TLS). As credenciais FEMA são armazenadas de forma segura e nunca expostas publicamente.

## 8. Alterações a esta política

Qualquer alteração relevante a esta política será comunicada através da documentação da app. A data de última atualização é indicada no topo desta página.


# Início Rápido
Source: https://ecommerce-docs.fema.pt/quickstart

Configure a integração FEMA e comece a criar envios em minutos.

## Passo 1: Credenciais FEMA

Aceda a **Apps** > **FEMA** > **Configurações** e abra o separador **Credenciais FEMA**.

1. Introduza o seu **utilizador** e **password** FEMA.
2. Clique em **Guardar**.

O badge passa de "Não configurado" para "Configurado" assim que as credenciais forem guardadas.

<Frame>
  <img alt="Configuração de credenciais FEMA" />
</Frame>

<Note>
  Se ainda não tem credenciais FEMA, contacte a FEMA em [fema.pt](https://www.fema.pt) para obter acesso.
</Note>

## Passo 2: Morada do remetente

Abra o separador **Morada de origem**.

1. Preencha o nome/empresa, morada, cidade, código postal e contacto.
2. Clique em **Guardar**.

Esta morada aparece em todas as guias de transporte como remetente.

<Frame>
  <img alt="Configuração da morada do remetente" />
</Frame>

## Passo 3: Mapeamento de envios

Abra o separador **Mapeamento de envios**.

Associe cada método de envio Shopify ao serviço FEMA correspondente. A app usa este mapeamento para saber que tipo de envio criar para cada encomenda.

<Frame>
  <img alt="Mapeamento de métodos de envio" />
</Frame>

<Tip>
  Se tiver vários métodos de envio no Shopify (ex: normal, expresso), crie um mapeamento para cada um.
</Tip>

## Passo 4: Embalagens

Abra o separador **Embalagens**.

Crie os templates das caixas que utiliza habitualmente. Em cada envio, basta selecionar a embalagem em vez de preencher dimensões e peso manualmente.

<Frame>
  <img alt="Configuração de embalagens" />
</Frame>

***

Está tudo pronto. Já pode criar envios FEMA diretamente a partir de qualquer encomenda no Shopify Admin.

<Columns>
  <Card title="Criar envio" icon="box" href="/extensions/admin-block">
    Crie um envio a partir de uma encomenda individual.
  </Card>

  <Card title="Criar em massa" icon="boxes-stacked" href="/extensions/bulk-action">
    Processe várias encomendas de uma vez.
  </Card>

  <Card title="Imprimir etiquetas" icon="print" href="/extensions/bulk-labels">
    Junte várias etiquetas num único PDF.
  </Card>

  <Card title="Estados de envio" icon="circle-info" href="/statuses">
    Referência de todos os estados de tracking FEMA.
  </Card>
</Columns>


# Estados de Envio
Source: https://ecommerce-docs.fema.pt/statuses

Lista completa dos estados FEMA e o que significam.

## Estados por fase

### Aguarda recolha

| Estado              | Descrição                               |
| ------------------- | --------------------------------------- |
| Aberta              | Guia criada, aguarda recolha pela FEMA  |
| Espera Levantamento | A aguardar levantamento pelo estafeta   |
| Espera Recolha      | A aguardar recolha                      |
| A Aguardar Recolha  | Variante de estado de espera de recolha |

### Recolhida / Em armazém

| Estado                            | Descrição                                            |
| --------------------------------- | ---------------------------------------------------- |
| Recolhida                         | Encomenda recolhida pelo estafeta                    |
| Entrada Armazém / Entrada Armazem | Entrada no armazém FEMA (variantes com e sem acento) |
| Verificada                        | Verificada em armazém                                |
| Exportada                         | Preparada para exportação                            |

### Em trânsito

| Estado                                 | Descrição                                      |
| -------------------------------------- | ---------------------------------------------- |
| Em Trânsito                            | Em trânsito para destino                       |
| Em Trânsito para as Ilhas              | Em trânsito para os Açores ou Madeira          |
| Em Trânsito para as Ilhas Espanholas   | Em trânsito para as ilhas Canárias ou Baleares |
| Em Trânsito para Plataforma de Destino | A caminho da plataforma de distribuição local  |

### Em distribuição

| Estado             | Descrição                           |
| ------------------ | ----------------------------------- |
| Em Distribuição    | Saiu para entrega hoje              |
| 2ª Volta           | Segunda tentativa de entrega no dia |
| Entrega Reagendada | Entrega reagendada para outra data  |

### Tentativa falhada

| Estado                 | Descrição                           |
| ---------------------- | ----------------------------------- |
| Entrega Parcial        | Entrega parcial (só alguns volumes) |
| Excepção               | Ocorreu uma exceção na entrega      |
| Entrega Não Conseguida | Tentativa de entrega sem sucesso    |

### Estados finais: entregue

<Check>Estes estados indicam entrega bem-sucedida.</Check>

| Estado                   | Descrição                                   |
| ------------------------ | ------------------------------------------- |
| **Entregue**             | Entregue ao destinatário                    |
| **Levantado na Agência** | Levantado pelo destinatário na agência FEMA |

### Estados finais: devolvido / cancelado

<Warning>Estes estados são finais. Não haverá mais atualizações automáticas.</Warning>

| Estado                          | Descrição                            |
| ------------------------------- | ------------------------------------ |
| Devolvida / Devolvido           | Devolvida ao remetente               |
| Devolvida Ao Remetente          | Devolvida ao remetente (variante)    |
| Devolvida ao Expedidor          | Devolvida ao expedidor               |
| Rejeitada                       | Rejeitada pelo destinatário          |
| Fechada                         | Envio fechado sem entrega            |
| Anulada / Envio Anulado         | Guia anulada                         |
| Envio Abandonado                | Envio abandonado                     |
| Destruído a Pedido do Expedidor | Destruído por instrução do remetente |

## Sincronização com Shopify

O estado de cada envio é sincronizado automaticamente com o Shopify:

| Estado FEMA                                                              | Evento Shopify       |
| ------------------------------------------------------------------------ | -------------------- |
| Em Trânsito / Recolhida / Entrada Armazém / Entrada Armazem              | `in_transit`         |
| Em Distribuição / 2ª Volta                                               | `out_for_delivery`   |
| Entrega Parcial / Excepção / Entrega Não Conseguida / Entrega Reagendada | `attempted_delivery` |
| Entregue / Levantado na Agência                                          | `delivered`          |
| Devolvida / Devolvida Ao Remetente / Rejeitada / Anulada / etc.          | `failure`            |