Agendar pagamento (json)

Exemplo do Corpo da Requisição

A requisição deve incluir um JSON no corpo (body) com os seguintes campos:

{
   "stakeholderId":"c22758c6-78ec-48a7-a164-e9285c4eb8e8",
   "description":"Pagamento fornecedor",
   "reference":"PAG-20240806-02",
   "scheduleDate":"2024-12-31",
   "dueDate":"2024-12-31",
   "accrualDate":"2024-12-31",
   "categories":[
      {
         "categoryId":"ec96c24b-a8f3-4c4e-996e-98d9b86d7bc7",
         "value":500.0         
      }
   ],
   "costCenterValueType":1,
   "costCenters":[
      {
         "costCenterId":"35e73eaf-bb6c-4e46-af92-82efa7e61a99",
         "percent":100,
				  "value": 100,
         "description":"Centro de Custo Principal"
      }
   ],  
   "instalment":[
      {
         "installmentnumber":1,
         "value":200.0,
         "duedate":"2024-12-31",
         "description":"parcela 1",
         "accrualdate":"2024-12-31",
         "scheduledate":"2024-12-31",
         "reference":"referência parcela 1"
      },
      {
         "installmentnumber":2,
         "value":200.0,
         "duedate":"2024-11-30",
         "description":"parcela 2",
         "accrualdate":"2024-11-30",
         "scheduledate":"2024-11-30",
         "reference":"referência parcela 2"
      }
   ],
   "recurrence": {
        "enabled": true,
        "intervaltype": 1,
        "interval": 1,
        "recurrenceendtype": 2,        
        "maxoccurrences": 0,
        "enddate": "2024-12-31"
    }
}

stakeholderId: identificador do contato(forncedor, funcionário ou sócio).
reference: "PAG-20240806-02" referência para o pagamento.
scheduleDate: Data prevista para o pagamento.
dueDate: Data de vencimento do pagamento.
accrualDate: Data de competência.
description: Descrição do agendamento.
categories: Lista de categorias relacionada ao pagamento, com categoryId, valor e descrição. Se o rateio estiver habilitado, poderá ser passado mais de uma categoria na lista de categories. Neste caso, cada item na lista representará uma parte do valor total, com a soma dos valores correspondendo ao valor total a receber. Se o rateio não estiver habilitado, você deve passar apenas uma categoria na lista de categories.
costCenterValueType: Tipo de valor do centro de custo (0 por valor, 1 para porcentagem).
Observações sobre o uso de Centros de Custo:
A lista de costCenters funciona da mesma forma que a de categories. Se o rateio estiver habilitado na empresa, você poderá passar uma lista com vários centros de custo, especificando a porcentagem ou o valor para cada um, dependendo do costCenterValueType que foi definido. Se o rateio não estiver habilitado, poderá ser enviado apenas um centro de custo na lista.
- Por porcentagem (costCenterValueType: 1): Cada centro de custo deve ter a porcentagem correspondente atribuída.
```
{
    "costCenterValueType": 1, // por porcentagem
    "costCenters": [
        {
            "costCenterId": "3e12a6b9-8f19-4e2b-a2d1-b6a4f895d823",
            "percent-":100
        }    
    ]
```
- Por valor (costCenterValueType: 0): Cada centro de custo deve ter o valor correspondente atribuído.
```
{
    "costCenterValueType": 0, // por valor
    "costCenters": [
        {
            "costCenterId": "3e12a6b9-8f19-4e2b-a2d1-b6a4f895d823",
            "value": 500
        }    
    ]
}
```
instalment: Parcelamento
- Permite realizar parcelamento, cada parcela será um agendamento criado.
- Se o campo de parcelamento (instalment) for utilizado, os valores de descrição e data de vencimento e valor serão obtidos das propriedades dentro de cada objeto de parcela e não das propriedades globais do payload. Ou seja:
  - A propriedade description de cada parcela será utilizada para descrever individualmente cada parcela.
  - A propriedade duedate de cada parcela será considerada como a data de vencimento dessa parcela específica.
  - A propriedade value das categorias informadas no campo categories será substituído pelo valor correspondente à parcela atual. Isso significa que o valor da categoria será determinado pelo valor da parcela em que está sendo aplicado, ignorando o valor global das categorias.
    
    As propriedades description e duedate externas ao objeto instalment não serão consideradas quando o parcelamento for informado.
recurrence: Recorrência
- enabled: Define se recorrência será ativada.
- intervaltype: Intervalo da recorrência. 0 = dia, 1 = semana, 2 = mês, 3 = ano
- interval: Define o intervalo entre as recorrências para a criação de ocorrências regulares.
- recurrenceEndType: Define o tempo fim da recorrência. 0 = indeterminado, 1 = por ocorrência, 2 = por data.
- maxOccurrences: Quantidade máxima da recorrência. Não deve ser preenchida ou o valor deve ser "0" recurrenceEndType for "por data.
- endDate: Data final da recorrência. Deve ser preenchida se recurrenceEndType for "por data"
Deve ser enviado apenas um objeto Parcelamento ou Recorrência