# Registrar Nota Fiscal

> ## Método POST
>
> [http://api.milksrota.com.br/pay/nfe/writeNfe](http://api.milksrota.com.br/pay/folha/readFolha)

## Requisição

### Dados da requisição

```javascript
{
    "conta_id": "{{conta_id}}",
    "token": "{{token}}",   
    "doc": "{{doc}}",
    "data": [
         {
           // Conjunto de registros de notas emitidas
           // de acordo com o formato da nota, documentado abaixo. 
        }
    ]    
}
```

{% hint style="info" %}
**token**: Deve ser informado o Token da conta, que você encontra na tela ***"Sua conta"*** no menu principal no painel do Milk's Rota.

**conta\_id**: Deve ser informado o ID da conta que você encontra na tela ***"Sua conta"*** no menu principal no painel do Milk's Rota.

**doc:** Deve ser informado o CNPJ da conta cadastra. Pode ser encontrado na tela ***"Sua conta"*** no menu principal do painel Milk's Rota.

**data:** Conjunto de registros de acordo com formato abaixo.
{% endhint %}

### Formato do registro da Nota  Fiscal

| **pagamento\_id**   | Id do registro de pagamento                                                  | Numérico                    | SIM |
| ------------------- | ---------------------------------------------------------------------------- | --------------------------- | --- |
| **destinatario**    | Documento de identificação do destinatário                                   | Texto                       | SIM |
| **emitente**        | Documento de identificação do emitente                                       | Texto                       | SIM |
| **tipo**            | Tipo de nota emitida (E) - Entrada ; (S) - Saída                             | Texto                       | SIM |
| **valor**           | Valor do documento                                                           | Double                      | SIM |
| **número**          | Número da NFE                                                                | Numérico                    | SIM |
| **série**           | Número de série da NFE                                                       | Numérico                    | SIM |
| **chave**           | Chave de identificação da NFE na base da SEFAZ                               | Texto                       | SIM |
| xml                 | Url para obtenção do XML da NFE ou Arquivo BASE64 com o conteúdo do XML      | Texto                       | NÃO |
| danfe               | Url para obtenção do DANFE da NFE ou Arquivo BASE64 com o conteúdo do DANFE. | Texto                       | NÃO |
| mensagem            | Mensagem de autorização de uso da NFE                                        | Texto                       | NÃO |
| **dt\_emissao**     | Data e Hora da Emissão da NFE                                                | Texto (YYYY-MM-DD HH:mm:ss) | SIM |
| **dt\_autorizacao** | Data da Autorização de Uso da NFE                                            | Texto (YYYY-MM-DD)          | SIM |

> **pagamento\_id**: Deve ser informado o ID de Identificação do pagamento, vinculado à folha de pagamento, que pode ser obtido por meio do método **"**[**Baixar Folha**](https://docs.milksrota.com.br/milks-pay/folha/enviar-categorias-1)**"** ,documentado nesta API.
>
> **XML e Danfe: Devem ser enviados os links (url) para acesso aos arquivos armazenados em servidor próprio, caso a empresa não tenha este recurso, entrar em contato com nossa equipe técnica.**

### Exemplo de requisição

```javascript
{
    "conta_id": "{{conta_id}}",
    "token": "{{token}}",   
    "doc": "{{doc}}",
    "data": [
         {
            "pagamento_id": "167", // Identificador do registro de pagamento vinculado a folha
            "destinatario": "99980339605", // Documento de identificação do destinatário na NFE 
            "emitente": "99988235000166", // Documento de identificaçào do emissor na NFE
            "tipo": "E", // (E) - Entrada ; (S) - Saída
            "valor": "6685.03", // Valor do Documento
            "numero": "1", // Número da NFE
            "serie": "2", // Série da NFE
            "chave": "31250155488235000166550020000000011740498179", // Chave de identificação 
            "xml": "https://milks-space-ny.nyc3.digitaloceanspaces.com/milks-pay/nfe/2554600/2025/01/xml/677e900e0263c2cc3893a4dc.xml",
            "danfe": "https://milks-space-ny.nyc3.digitaloceanspaces.com/milks-pay/nfe/2554600/2025/01/pdf/677e900e0263c2cc3893a4dc.pdf",
            "mensagem":"Autorizado o uso da NF-e",
            "dt_emissao":"2025-01-08 09:00:00",
            "dt_autorizacao": "2025-01-08"
        }
    ]    
}
```

## Resposta

### 200: Registros processados

{% hint style="success" %}
Os registros das notas foram processados pela plataforma Milk's Rota com sucesso.
{% endhint %}

```javascript
{
    "success": true,
    "results": {
        "aceitas": 1,
        "recusadas": 0,
        "erros": []
    },
    "response.time": 0.615164041519165,
    "server.date": "2025-01-21 09:41:51"
}
```

### 400: Conta não localizada

{% hint style="danger" %}
**O que isso significa?** Significa que o ID da conta não foi localizado na Plataforma Milk's.
{% endhint %}

### 403: Token inválido

```javascript
{
    "success": false,
    "message": "Token inválido",
    "data": [],
    "monitor.time": 2.14737200737 // Tempo de execução
}
```

{% hint style="danger" %}
**O que isso significa?** Significa que o token informado na requisição não corresponde ao token cadastrado para a conta.
{% endhint %}