Buscar Entrada de Carteira por Chave

A busca de entrada de carteira por chave retornará os detalhes completos de uma entrada específica, incluindo todos os itens da fatura relacionados.

Request

ENDPOINT

/wallet/WALLET_KEY/wallet_entry/WALLET_ENTRY_KEY

MÉTODO

GET

Path Parameters

Campo	Tipo	Descrição	Caracteres
wallet_key	uuidv4	Chave única da carteira no formato UUID v4	36
wallet_entry_key	uuidv4	Chave única da entrada no formato UUID v4	36

Response

STATUS

200

Response Body: Detalhes da entrada de carteira

{
  "wallet_entry_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
  "wallet_entry_amount": 150.00,
  "wallet_entry_settlement_key": "cc8fb19b-d1e4-4ce6-ad4c-61e0609a8f8d",
  "wallet_entry_type": "revolving_credit",
  "wallet_entry_status": "active",
  "invoice_items": [
    {
      "invoice_item_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "invoice_key": "f2cad6b4-2a68-9572-99a7-2849c8d6ecf8",
      "wallet_entry_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
      "payment_instrument_entry_key": null,
      "installment_number": 1,
      "invoice_description": "Crédito rotativo - Taxa de juros",
      "amount": 150.00,
      "used_limit": 150.00,
      "paid_amount": 0.00,
      "invoice_item_status": "active",
      "invoice_item_due_date": "2024-02-15",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "created_at": "2024-01-15T10:30:00Z"
}

Response Body Params

Campo	Tipo	Descrição	Caracteres
wallet_entry_key *	uuidv4	Chave única de identificação da entrada no formato uuid v4	36
wallet_entry_amount *	float	Valor da entrada	-
wallet_entry_settlement_key *	string	Chave de liquidação da entrada	-
wallet_entry_type *	string	Tipo da entrada da carteira	Enumeradores wallet_entry_type
wallet_entry_status *	string	Status da entrada da carteira	Enumeradores wallet_entry_status
invoice_items *	object array	Itens da fatura relacionados	Objeto invoice_item
created_at *	string	Data de criação (formato ISO 8601 UTC)	-

Objeto invoice_item

Campo	Tipo	Descrição	Caracteres
invoice_item_key *	uuidv4	Chave única de identificação do item da fatura no formato uuid v4	36
invoice_key *	uuidv4	Chave única de identificação da fatura no formato uuid v4	36
wallet_entry_key	uuidv4	Chave única de identificação da entrada da carteira no formato uuid v4	36
payment_instrument_entry_key	uuidv4	Chave única de identificação da entrada do instrumento de pagamento no formato uuid v4	36
installment_number *	integer	Número da parcela	-
invoice_description *	string	Descrição do item da fatura	-
amount *	float	Valor do item	-
used_limit *	float	Limite utilizado	-
paid_amount *	float	Valor pago	-
invoice_item_status *	string	Status do item da fatura	Enumeradores invoice_item_status
invoice_item_due_date *	string	Data de vencimento do item (formato YYYY-MM-DD)	10
created_at *	string	Data de criação (formato ISO 8601 UTC)	-

Enumeradores wallet_entry_type

Enumerador	Descrição
revolving_credit	Crédito rotativo
payroll_withdraw	Saque de folha

Enumeradores wallet_entry_status

Enumerador	Descrição
active	Entrada ativa e disponível para uso

Enumeradores invoice_item_status

Enumerador	Descrição
active	Item pendente de pagamento

Error Response

STATUS

4xx

Response Body: Error

{
  "title": "titulo",
  "description": "description in English",
  "translation": "descrição em portugues",
  "code": "codigo",
  "extra_fields": {}
}

Código HTTP status	Código QI code	Título title	Descrição (eng) description	Descrição (pt-br) translation
404	CIN000007	Wallet not Found	Wallet with key: abeca0d0-a09d-4b3b-a495-40b553422ced was not found	Carteira com a chave: abeca0d0-a09d-4b3b-a495-40b553422ced não foi encontrado
404	CIN000078	Not Found	Wallet entry with key: 8cb70dea-9fb0-4a68-9572-99a72849c8d6 was not found	Dívida da carteira com a chave: 8cb70dea-9fb0-4a68-9572-99a72849c8d6 não foi encontrado