# Cobrança

## Arquivo diário de remessa

A loja envia diariamente, via e-mail, um arquivo contendo os novos clientes disponibilizados para a assessoria, Os pagamentos de parcela e acordos firmados em loja do dia anterior.

[**Download arquivo exemplo.**](http://tagone.com.br/downloads/remessa-exemplo.xml)

### EndPoint para download da remessa via API

Download do mesmo arquivo enviado via e-mail, arquivo XML compactado em ZIP.

<mark style="color:blue;">`GET`</mark> `/odata/CobrancaArquivo/DownloadRemessa(token='value', remessa=value)`

EndoPoint para download do arquivo de remessa.

#### Path Parameters

| Name                                      | Type   | Description                                            |
| ----------------------------------------- | ------ | ------------------------------------------------------ |
| token<mark style="color:red;">\*</mark>   | String | *Solicite ao lojista seu token de acesso*              |
| remessa<mark style="color:red;">\*</mark> | int    | *CodigoRemessa existente no arquivo de remessa diário* |

## Retornos da assessoria

Os acordos simulados pela assessoria devem ser notificados via API, Preferencialmente notificar no ato da negociação pois o TagOne já irá disponibilizar um link de pagamento para o cliente.

### Criando um novo acordo

{% hint style="warning" %}
**POST**: *`https://[empresa].treina.tagone.com.br/odata/Acordo`*
{% endhint %}

```csharp
{
    "CodigoPessoa": "000000000000000",
    "QuantidadeParcelas": 0,
    "DataEntrada": "YYYY-MM-DD",
    "PrimeiroVencimento": "YYYY-MM-DD",
    "ValorEntrada": 0.00,
    "ValorDesconto": 0.00,
    "ValorAcrescimo": 0.00,
    "ValorMulta": 0.00,
    "ValorJuros": 0.00,
    "ValorAcordo": 0.00,
    "ValorJurosAcordo": 0.00,
    "JurosParcelamento": 0,
    "ValorDocumentos": 334.92,
    "CodigoAcordoTipo": 2, //FIXO 2
    "Faturar" : false,
    "Parcelas": [
        {
            "NumeroParcela": 1,
            "ValorParcela": 0,
            "DataVencimento": "YYYY-MM-DDZ"
        }
    ],
    "Documentos": [
        {
            "CodigoAcordoDocumento": 0,
            "CodigoDocumento": "000000000000000",
            "ValorDocumento": 0.00,
            "ValorJuros": 0.00,
            "ValorMulta": 0.00
        }
    ]    
}
```

{% hint style="success" %}
**RESPONSE 200**: `SUCESSO`
{% endhint %}

Devolve um objeto com todos os dados no novo acordo, Incluindo códigos dos novos documentos e link para a fatura

```csharp
{
    "CodigoPessoa": "000000000000000",
    "QuantidadeParcelas": 0,
    "DataEntrada": "YYYY-MM-DD",
    "PrimeiroVencimento": "YYYY-MM-DD",
    "ValorEntrada": 0.00,
    "ValorDesconto": 0.00,
    "ValorAcrescimo": 0.00,
    "ValorMulta": 0.00,
    "ValorJuros": 0.00,
    "ValorAcordo": 0.00,
    "ValorJurosAcordo": 0.00,
    "JurosParcelamento": 0,
    "ValorDocumentos": 334.92,
    "CodigoAcordoTipo": 2,    
    "Parcelas": [
        {
            "NumeroParcela": 1,
            "ValorParcela": 0,
            "DataVencimento": "YYYY-MM-DDZ"
        }
    ],
    "Documentos": [
        {
            "CodigoAcordoDocumento": 0,
            "CodigoDocumento": "000000000000000",
            "ValorDocumento": 0.00,
            "ValorJuros": 0.00,
            "ValorMulta": 0.00
        }
    ]    
}
```

{% hint style="danger" %}
**RESPONSE 500:** `Qualquer tipo de falha`
{% endhint %}

```csharp
{
  "title": "Internal Server Error",
  "status": 500,
  "detail": "Mensagem de erro"
}
```

### Link de pagamento

Criando uma nova link de pagamento de um ou mais documentos sem a criação de um novo acordo.

{% hint style="info" %}
**POST**: *`https://[empresa].treina.tagone.com.br/odata/Fatura/GerarFatura`*
{% endhint %}

```csharp
{
    "codigopessoa": "007000000000545",
    "taxa": 2,
    "desconto": 0,
    "data": "2020-10-06",
    "documentos": [
        "999999276149169",
        "999999276149170",
        "999999276149171"
    ],
    "acordo": 0,
    "geraBoleto": false
}
```

{% hint style="success" %}
**RESPONSE 200**: `SUCESSO`
{% endhint %}

Devolve um objeto com todos os dados no novo acordo, Incluindo códigos dos novos documentos e link para a fatura

```csharp
{
    "CodigoFatura": 7021,
    "CodigoPessoa": "007000000000545",
    "CodigoSituacaoFatura": 0,
    "Token": "DFH49GFH",
    "Titulo": "FATURA DE CREDIARIO",
    "CodigoAcordo": null,
    "DataFatura": "2020-10-06T13:26:57.5907777Z",
    "DataValidade": "2020-10-07T00:00:00Z",
    "Valor": 374.95,
    "ValorDesconto": 0,
    "TaxaBoleto": 2,
    "TaxaServico": 0,
    "Valida": true,
    "LinkFatura": "https://pague-in/[empresa]/[id]",
    "LinkBoleto": null,
    "TransactionId": null,
    "EnumSituacaoFatura": "Gerada",
    "CodigoBarra": null,
    "DataCriacao": "2020-10-06T13:26:57.7047457Z",
    "UsuarioCriacao": "NERD",
    "DataAlteracao": "2020-10-06T13:26:57.7047457Z",
    "UsuarioAlteracao": "NERD",
    "BitSincronia": 0,
    "Situacao": true
}
```

{% hint style="danger" %}
**RESPONSE 500:** `Qualquer tipo de falha`
{% endhint %}

```csharp
{
  "title": "Internal Server Error",
  "status": 500,
  "detail": "Mensagem de erro"
}
```


---

# Agent Instructions: 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:

```
GET https://ajuda.tagone.com.br/integracoes/api/api-cobranca.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.