> For the complete documentation index, see [llms.txt](https://alcavie-systems-1.gitbook.io/suporte/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alcavie-systems-1.gitbook.io/suporte/sistema/produtos-e-estoque/enviar-xml.md).

# Enviar XML

A funcionalidade de envio de XML permite agilizar o cadastro de novos produtos e a atualização de estoque utilizando a nota fiscal eletrônica (modelo 55). O sistema extrai as informações da nota e preenche automaticamente os dados dos produtos, evitando a necessidade de inserção manual.

***

{% hint style="danger" %}
**Importante!** 

O Alcavie **não armazena notas fiscais de entrada**. O XML é utilizado apenas para processar os produtos contidos na nota.
{% endhint %}

## <mark style="background-color:blue;">**Como enviar uma Nota XML**</mark>

1. Acesse o menu **Produtos** e clique em **Enviar XML**.
2. Selecione o arquivo XML referente à nota fiscal (modelo 55) e clique em **Enviar**.
3. O sistema exibirá uma janela com todos os produtos contidos na nota, incluindo:
   * Nome do produto;
   * Cód.;
   * Quantidade;
   * Preço unitário;
   * Preço total.

<figure><img src="/files/NpOt8Z5pTTg4HDK2b0WS" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/wszm4kpaquxcJ5XdXD1i" alt=""><figcaption></figcaption></figure>

***

## <mark style="background-color:blue;">**Cadastrando ou atualizando estoque com a Nota XML**</mark>

Para vincular cada item da nota ao sistema, clique na lupa no campo **SKU no Alcavie** e escolha entre duas opções:

### <mark style="background-color:purple;">**1. Cadastrar um novo produto**</mark>

Se o produto ainda não está cadastrado no sistema:

1. Siga pela opção "**Ainda não cadastrou o produto no sistema?**
2. Selecione **Cadastrar Produto**.
3. O sistema preencherá automaticamente os campos com as informações extraídas da nota. Você pode editar ou remover qualquer dado antes de salvar.
4. Após revisar as informações, clique em **Criar Produto** para finalizar o cadastro.

<figure><img src="/files/mt3Gfd2BzkyyjErsI8DM" alt="" width="563"><figcaption></figcaption></figure>

5. Após a criação do produto **não** é necessário vincular ele ao produto da Nota, como feito para atualização do estoque.&#x20;
6. Ao finalizar o cadastro de um produto, ele já está válido e ativo no sistema mesmo que demais itens da nota ainda não tenham sido criados.
7. Não é necessário utilizar o botão "Enviar XML" ao finalizar o cadastro de produtos.

***

{% hint style="warning" %}
**ATENÇÃO!**

Se ao tentar criar um produto, o sistema retornar o erro "**Não foi possível cadastrar o produto. Tente novamente mais tarde...",.** Verifique o SKU do produto.&#x20;

O SKU do produto será gerado a partir do cód. informado abaixo do nome do produto. Caso esse código seja repetido para mais de um produto, pode ocorrer erro no cadastro. Se isso acontecer:

* Deixe o SKU em branco para que o sistema gere um automaticamente.
* Ou altere o SKU manualmente para um código único de sua escolha, que não esteja em uso com outro produto.
  {% endhint %}

<figure><img src="/files/BExWC1VK2tfDnpQFHAKp" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/76jLRdJNGpUO7CLxmvdM" alt="" width="563"><figcaption></figcaption></figure>

***

### <mark style="background-color:purple;">**2. Atualizar estoque**</mark>

Se o produto já foi cadastrado no sistema anteriormente:&#x20;

1. Siga na opção "**Já possui o produto cadastrado no sistema?"**
2. Utilize a busca para localizar o produto no sistema pelo **Nome, SKU ou Código de Barras** como feito nas vendas.
3. Ao encontrar o produto correspondente, clique em **Escolher** para vinculá-lo. O estoque será atualizado automaticamente após finalizar o envio da nota, seguindo de acordo com a quantidade informada na nota fiscal.

<figure><img src="/files/6Jbg503ZUYnNV738mfOR" alt="" width="563"><figcaption></figcaption></figure>

<mark style="background-color:blue;">**2.1 Finalizando o processo de estoque**</mark>

* Após vincular todos os produtos que deseja aumentar o estoque, clique em **Enviar XML** para concluir.
* **Todos os produtos devem estar vinculados** a um item já cadastrado.
* Após clicar para enviar, a página carregará e todos os produtos estarão com o estoque atualizado.&#x20;

{% hint style="warning" %}
Não é necessário realizar essa etapa caso seja o cadastro de novos produtos! Ela serve apenas para atualização de etoque de produtos já cadastrados.&#x20;
{% endhint %}

<figure><img src="/files/4MBMdOwnIGLvve3bfLNE" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="warning" %}
**ATENÇÃO!**

Caso saia da página sem salvar as alterações e não consiga reenviar a nota, entre em contato com o suporte para que possamos liberar o reenvio do XML.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://alcavie-systems-1.gitbook.io/suporte/sistema/produtos-e-estoque/enviar-xml.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.