> For the complete documentation index, see [llms.txt](https://ajuda.tagone.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.tagone.com.br/integracoes/api-cobranca.md).

# 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"
}
```