---
title: "Criar Agendamento de Cobrança para Pix Automático"
method: POST
path: "/automatic-pix/authorization/{authorizationId}/scheduling-instruction"
tags: ["Authorization"]
---

# Criar Agendamento de Cobrança para Pix Automático

`POST /automatic-pix/authorization/{authorizationId}/scheduling-instruction`

API responsável por criar agendamento de uma cobrança de Pix Automático

## Path parameters

- `authorizationId` string, uuid, required — Id da autorização do Pix Automático

## Request body

- CreateSchedulingRequest
  - `scheduledDate` string, required — Data do agendamento (respeitar a antecedência de 3 a 10 dias em relação à data prevista para a liquidação)
  - `amount` number, required — Valor
  - `additionalInformation` string — Descrição do agendamento
  - `txId` string

## Response `201`

Agendamento criado com sucesso.

- SchedulingInstructionResponse
  - `id` string, uuid, required — Id do agendamento
  - `authorizationId` string, uuid, required — Id da autorização do Pix Automático
  - `createdAt` string, required — Data da criação
  - `installmentNumber` number — Número da parcela (existirá apenas caso a autorização do Pix Automático tenha uma data final definida)
  - `scheduledDate` string, required — Data do agendamento (respeitar a antecedência de 3 a 10 dias em relação à data prevista para a liquidação)
  - `amount` number, required — Valor
  - `additionalInformation` string — Descrição do agendamento
  - `updatedAt` string — Data da atualização
  - `status` 'WAITING_SCHEDULING' | 'SENT_SCHEDULING' | 'CONFIRMED' | 'PAID' | 'CANCELED' | 'CANCELING' | 'REJECTED' | 'EXPIRED' | 'FAILED', required — Status do agendamento
  - `periodInitialDate` string — Data início do ciclo
  - `periodFinalDate` string — Data final do ciclo
  - `payee` Payee, required — Emissor
    - `document` string
    - `fantasyName` string — Nome
    - `socialName` string — Nome
    - `bankCode` string — Código bancário
    - `bankName` string — Nome
  - `origin` string, required
  - `canceledAt` string — Data de cancelamento
  - `cancellationCode` 'ACCT' | 'BLCK' | 'CCLD' | 'FAIL' | 'OTHR' | 'SLBD' | 'SLCR' — Scheduling Instruction Cancellation Code: - `ACCT`: Encerramento da conta transacional do usuário pagador ou do usuário recebedor - `BLCK`: Bloqueio da conta transacional do usuário pagador ou do usuário recebedor - `CCLD`: Autorização cancelada - `FAIL`: Falha no fluxo de liquidação - `OTHR`: Solicitado pela instituição financeira do pagador ou recebedor - `SLBD`: Solicitado pelo usuário pagador - `SLCR`: Solicitado pelo usuário recebedor
  - `cancellationDescription` string
  - `settledAt` string — Data da liquidação
  - `paidAt` string — Data do pagamento
  - `rejectedAt` string — Data da rejeição
  - `rejectionCode` 'AB10' | 'AC05' | 'AC06' | 'AG12' | 'AM02' | 'AM09' | 'DENC' | 'DS27' | 'DTED' | 'DTNT' | 'FBRD' | 'IRNT' | 'MIDI' | 'MSUC' | 'NIEC' | 'NIPA' | 'NITX' | 'QUNT' | 'RC09' | 'UDEI' | 'PRJL' | 'FF08' | 'CRNC' | 'CH16' — Scheduling Instruction Rejection Code: - `AB10`: Transação interrompida devido a um erro na instituição financeira do usuário pagador - `AC05`: A conta transacional do usuário pagador foi encerrada - `AC06`: A conta transacional do usuário pagador está bloqueada - `AG12`: A solicitação de agendamento não é permitida de uma conta transacional para outra dentro da mesma instituição financeira - `AM02`: O valor cobrado excede o valor máximo definido pelo usuário pagador - `AM09`: O valor cobrado não corresponde ao valor definido na autorização do Pix Automático - `DENC`: O número do documento do usuário pagador não corresponde aos dados contidos na autorização do Pix Automático - `DS27`: A instituição financeira não está registrado ou ainda não iniciou as operações no SPI - `DTED`: A data de agendamento não corresponde à frequência da autorização do Pix Automático com base na última programação e/ou regras do produto - `DTNT`: Não são permitidas novas tentativas de agendamento após a data de vencimento além do limite da regra de negócios - `FBRD`: Solicitação de agendamento recebida após o prazo para cumprimento das regras comerciais - `IRNT`: Essa autorização de Pix Automático não permite novas tentativas de agendamento após o vencimento - `MIDI`: O ID da autorização de Pix Automático informado não existe ou está incorreto - `MSUC`: Agendamento rejeitado pois a autorização do Pix Automático não está aprovada - `NIEC`: A nova instrução de agendamento é inválida porque a mesma cobrança já possui um agendamento em aberto - `NIPA`: A nova instrução de agendamento é inválida, o agendamento já foi feito - `NITX`: A nova instrução de agendamento não corresponde a uma autorização de Pix Automático - `QUNT`: O número de novas tentativas de agendamento após a data de vencimento excede o limite definido pela regra de negócios - `RC09`: O número de ISPB da instituição financeira do usuário pagador é inválido ou inexistente - `UDEI`: O número do documento do devedor está incorreto - `PRJL`: Cancelamento de agendamento inválido, pois o pagamento já foi concluído com sucesso - `FF08`: O EndToEnd da transação não corresponde ao valor informado originalmente - `CRNC`: O número do documento do usuário destinatário não corresponde aos dados contidos na autorização - `CH16`: O identificador da transação não corresponde ao valor informado originalmente
  - `rejectionDescription` string

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/btgpactual/apis/folha-de-pagamentos.md) · [All operations](https://skmtc.net/btgpactual/apis/folha-de-pagamentos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/btgpactual/folha-de-pagamentos/revisions/2a24d3da114c/schema)