1. Pré-Autorização
  • Introdução
    • Integração ONE
    • Visão Geral da API Rest
    • Ciclo de Vida da API
  • Ambiente
    • Ambiente
  • Autenticação
    • Gerando Chaves de Acesso
    • Autenticando-se
    • Token de Acesso
      POST
  • Pré-Autorização
    • Entendendo a Pré-Autorização
    • Criar uma Pré-Autorização
      POST
    • Cancelar uma Pré-Autorização
      PATCH
  • Webhooks
    • Utilizando Webhooks
    • Eventos
      • Entendendo o Payload
      • Atualização de Pré-Autorização
      • Atualização de Prospecção de Antecipação
      • Atualização de Antecipação
      • Troca de Boletos
  1. Pré-Autorização

Criar uma Pré-Autorização

POST
/api/v1/oneos/prospects/pre-authorizations
Enpoint responsável por criar as pré-autorizações via integração.

Request

Header Params

Body Params application/json

Example
{
  "projectIdentifier": "Projeto Maracanã",
  "uniqueId": "PRJ-01",
  "clientTaxId": "string",
  "contractedTaxId": "99999999999999",
  "contractedEmail": "test@test.com",
  "contractedReceiptNumber": "0001",
  "constructorInvoice": {
    "originalAmount": 10000,
    "withHoldTaxAmount": 1000,
    "discountedAmount": 9000,
    "dueDate": "2022-10-05",
    "number": "0001",
    "description": "Compra de cimento"
  },
  "contractedReceipt": {
    "contentBase64": "string"
  }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://one.app-hm.oneos.com.br/api/v1/oneos/prospects/pre-authorizations' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "projectIdentifier": "Projeto Maracanã",
  "uniqueId": "PRJ-01",
  "clientTaxId": "string",
  "contractedTaxId": "99999999999999",
  "contractedEmail": "test@test.com",
  "contractedReceiptNumber": "0001",
  "constructorInvoice": {
    "originalAmount": 10000,
    "withHoldTaxAmount": 1000,
    "discountedAmount": 9000,
    "dueDate": "2022-10-05",
    "number": "0001",
    "description": "Compra de cimento"
  },
  "contractedReceipt": {
    "contentBase64": "string"
  }
}'

Responses

🟢200OK
application/json
Body

Example
{
    "id": 1,
    "projectIdentifier": "Projeto Maracanã",
    "constructorName": "One Construction",
    "clientTaxId": "99999999999999",
    "prospectAnticipationId": 1,
    "expirationDate": "2022-10-05",
    "uniqueId": "Projeto Maracanã",
    "status": "WAITING_CONTRACTED",
    "revocationReason": "string",
    "constructorInvoice": {
        "originalAmount": 1000,
        "withHoldTaxAmount": 100,
        "dueDate": "2022-10-05",
        "number": "0001",
        "description": "Compra de cimento"
    },
    "contractedReceiptNumber": "string"
}
Modified at 2024-07-19 19:04:21
Previous
Entendendo a Pré-Autorização
Next
Cancelar uma Pré-Autorização
Built with