Criar Ordem

Sumário

Endpoints
Requisição (POST)
- Parâmetros de Requisição
  - Cabeçalho
  - Corpo (JSON)
Resposta
- Parâmetros de Resposta
  - Corpo (JSON)

Este passo tem por finalidade gerar uma ordem e um boleto

Endpoints #

Produção: https://sbc.bancosemear.com.br/sbc/orders

Requisição (POST) #

Segue exemplo de requisição:

curl "https://sbc.bancosemear.com.br/sbc/orders" \
    --request POST \
    --header "Content-Type: application/json" \
    --header 'Cookie: session=<sessão_login>' \
    --data '
{
  "currencyPair": "USDBRL",
  "expiresIn": 60,
  "clientId": "ee81f3a4-aaaa-47d1-a841-cc1870b5c48d",
  "dataLq": "14/05/2025",
  "dataMe": "14/05/2025",
  "dataMn": "14/05/2025",
  "dataOp": "14/05/2025",
  "modalidade": "REMESSA",
  "obs": "",
  "remitter": "Empresa XYZ",
  "document": "12345678000199",
  "valueForeign": 1000.00,
  "valueNational": 5618.90,
  "currencyCode": 220,
  "countryCode": 0,
  "quoteId": "26e59108-aaaa-42ca-a367-2fab1e197e37",
  "spreadType": "percent",
  "spreadValue": 1.5,
  "side": "VENDA"
}
'

Parâmetros de Requisição #

Cabeçalho #

Content-Type: Informa ao servidor de que o corpo da requisição possui o formato JSON
session: Token de autorização obtido no processo de login

Corpo (JSON) #

Propriedade	Descrição	Tipo	Obrigatoriedade
currencyPair	Par da moeda a ser cotada. Exemplo: USDBRL, EURBRL, GBPBRL	String	Obrigatório
expiresIn	Validade da cotação em segundos	Int	Obrigatório
clientId	ID de cliente único (informado pelo Banco Semear no momento do onboarding)	String	Obrigatório
dataLq	Data de liquidação	Datetime	Obrigatório
dataMe	Data de liquidação da moeda estrangeira	Datetime	Obrigatório
dataMn	Data de liquidação da moeda nacional	Datetime	Obrigatório
dataOp	Data da operação	Datetime	Obrigatório
modalidade	Modalidade da operação	String	Obrigatório
obs	Observações	String	Obrigatório
remitter	Remetente	String	Obrigatório
document	Documento do pagador (CPF/CNPJ)	Int	Obrigatório
valueForeign	Valor na moeda estrangeira	Float	Obrigatório
valueNational	Valor na moeda nacional	Float	Obrigatório
currencyCode	Código da moeda	Int	Obrigatório
countryCode	Código do país	Int	Obrigatório
quoteId	ID da cotação criada previamente	String	Obrigatório
spreadType	Tipo do spread (percent ou fixed)	String	Obrigatório
spreadValue	Valor do spread	Float	Obrigatório
side	Lado da ordem (compra ou venda)	String	Obrigatório

Resposta #

Segue exemplo de resposta:

{
  "currencyPair": "USDBRL",
  "expiresIn": 90,
  "clientId": "ee81f3a4-b08a-47d1-a841-cc1870b5c48d",
  "dataLq": "14/05/2025",
  "dataMe": "14/05/2025",
  "dataMn": "14/05/2025",
  "dataOp": "14/05/2025",
  "modalidade": "REMESSA",
  "obs": "",
  "remitter": "Empresa XYZ",
  "document": "12345678000199",
  "valueForeign": 1000.00,
  "valueNational": 5618.90,
  "currencyCode": 220,
  "countryCode": 0,
  "quoteId": "26e59108-80a2-42ca-a367-2fab1e197e37",
  "spreadType": "percent",
  "spreadValue": 1.5,
  "side": "VENDA",
  "orderId": 44,
  "boletoId": 4333
}

Parâmetros de Resposta #

Corpo (JSON) #

Propriedade	Descrição	Tipo
currencyPair	Par da moeda a ser cotada. Exemplo: USDBRL, EURBRL, GBPBRL	String
expiresIn	Validade da cotação em segundos	Int
clientId	ID de cliente único (informado pelo Banco Semear no momento do onboarding)	String
dataLq	Data de liquidação	Datetime
dataMe	Data de liquidação da moeda estrangeira	Datetime
dataMn	Data de liquidação da moeda nacional	Datetime
dataOp	Data da operação	Datetime
modalidade	Modalidade da operação	String
obs	Observações	String
remitter	Remetente	String
document	Documento do pagador (CPF/CNPJ)	Int
valueForeign	Valor na moeda estrangeira	Float
valueNational	Valor na moeda nacional	Float
currencyCode	Código da moeda	Int
countryCode	Código do país	Int
quoteId	ID da cotação criada previamente	String
spreadType	Tipo do spread (percent ou fixed)	String
spreadValue	Valor do spread	Float
side	Lado da ordem (compra ou venda)	String
orderId	ID único da ordem criada	Int
boletoId	ID único do boleto criado	Int