1. Orders
Kapitale
  • Integration Guide
    • πŸ“‹ Introduction
    • πŸ” Authentication
    • πŸš€ Integration Flow
    • πŸ”” Webhooks
    • πŸ”„ Integration Flowchart
    • πŸ§ͺ Sandbox Environment
    • πŸ“Š Status Map
    • ⚠️ Error Handling
    • πŸ“ Practical Examples
    • πŸ’³ Receivable Consultation
    • πŸ“ž Support
  • API
    • Retail
      • Fetch retail information by CNPJ
    • Orders
      • Create a new order
        POST
      • List orders
        GET
      • Fetch order by ID
        GET
      • Set payment invoice
        PATCH
      • Cancel order
        PATCH
    • Receivable
      • Fetch receivables by CNPJ
  • Schemas
    • CreateOrderRequest
    • RetailInfo
    • Acquirer
    • CancelOrderRequest
    • PurchaseItem
    • Order
    • FindReceivableResponse
    • OrderStatus
    • PaymentStatus
    • FindByIndustryCnpjResponse
    • OrderStatistics
    • Error
    • ReceivableItem
  1. Orders

Set payment invoice

Partners Integration - Production
https://partners.kapitale.com.br/v1
Partners Integration - Production
https://partners.kapitale.com.br/v1
PATCH
/order/invoice/{order_id}
Sets the payment invoice for an order. Requires invoice file upload and invoice number. Scope: orders.sentnf

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Path Params

Body Params multipart/form-dataRequired

Responses

🟒200
Invoice set successfully (empty response)
This response does not have a body.
🟠404
🟠409
🟠400BadRequest
🟠401Unauthorized
πŸ”΄500InternalServerError
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://partners.kapitale.com.br/v1/order/invoice/550e8400-e29b-41d4-a716-446655440000' \
--header 'Authorization: Bearer <token>' \
--form 'invoice_number=""' \
--form 'invoice=@""'
Response Response Example
404 - Example 1
{
    "statusCode": 400,
    "message": "Invalid CNPJ. Please check and try again.",
    "error": "Bad Request"
}
Modified atΒ 2026-03-19 13:59:13
Previous
Fetch order by ID
Next
Cancel order
Built with