RevUp Finance API (1.0.0)
Download OpenAPI specification:Download
RevUp Finance Support: hello@revup.finance
API for RevUp Finance services
Create a new invoice
Authorizations:
ApiKeyAuth
Request Body schema: application/jsonrequired
| number required | string |
| dueDate required | string <date-time> |
| status required | string Default: "DRAFT" Value: "DRAFT" |
| total required | number |
| subTotal required | number |
required | Array of objects (InvoiceItem) |
object (Customer) | |
| memo | string |
| attachPastDue | boolean Default: true |
| createdDate required | string <date-time> |
Responses
Request samples
- Payload
Content type
application/json
{- "number": "INV-001",
- "dueDate": "2024-09-30T14:15:22Z",
- "status": "DRAFT",
- "total": 1,
- "subTotal": 1,
- "items": [
- {
- "price": 0,
- "quantity": 0,
- "subTotal": 0,
- "total": 0
}
], - "customer": {
- "firstName": "string",
- "lastName": "string",
- "email": "user@example.com",
- "compositeKey": "string"
}, - "memo": "string",
- "attachPastDue": true,
- "createdDate": "2024-11-30T14:15:22Z"
}Response samples
- 200
Content type
application/json
{- "res": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "merchantId": "string",
- "number": "string",
- "dueDate": "2019-08-24T14:15:22Z",
- "status": "DRAFT",
- "total": 0,
- "subTotal": 0,
- "items": [
- {
- "price": 0,
- "quantity": 0,
- "subTotal": 0,
- "total": 0
}
], - "customer": {
- "firstName": "string",
- "lastName": "string",
- "email": "user@example.com",
- "compositeKey": "string"
}, - "memo": "string",
- "attachPastDue": true,
- "createdDate": "2019-08-24T14:15:22Z"
}
}Response samples
- 200
Content type
application/json
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "merchantId": "string",
- "number": "string",
- "dueDate": "2019-08-24T14:15:22Z",
- "status": "DRAFT",
- "total": 0,
- "subTotal": 0,
- "items": [
- {
- "price": 0,
- "quantity": 0,
- "subTotal": 0,
- "total": 0
}
], - "customer": {
- "firstName": "string",
- "lastName": "string",
- "email": "user@example.com",
- "compositeKey": "string"
}, - "memo": "string",
- "attachPastDue": true,
- "createdDate": "2019-08-24T14:15:22Z"
}Response samples
- 200
Content type
application/json
{- "updated": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "merchantId": "string",
- "number": "string",
- "dueDate": "2019-08-24T14:15:22Z",
- "status": "DRAFT",
- "total": 0,
- "subTotal": 0,
- "items": [
- {
- "price": 0,
- "quantity": 0,
- "subTotal": 0,
- "total": 0
}
], - "customer": {
- "firstName": "string",
- "lastName": "string",
- "email": "user@example.com",
- "compositeKey": "string"
}, - "memo": "string",
- "attachPastDue": true,
- "createdDate": "2019-08-24T14:15:22Z"
}
}Update invoice status (Will trigger reconciliation)
Authorizations:
ApiKeyAuth
path Parameters
| id required | string <uuid> |
Request Body schema: application/jsonrequired
| status | string Enum: "PAID" "PAID_IN_CASH" "PARTIAL" |
Responses
Request samples
- Payload
Content type
application/json
{- "status": "PAID"
}Response samples
- 200
Content type
application/json
{- "updated": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "merchantId": "string",
- "number": "string",
- "dueDate": "2019-08-24T14:15:22Z",
- "status": "DRAFT",
- "total": 0,
- "subTotal": 0,
- "items": [
- {
- "price": 0,
- "quantity": 0,
- "subTotal": 0,
- "total": 0
}
], - "customer": {
- "firstName": "string",
- "lastName": "string",
- "email": "user@example.com",
- "compositeKey": "string"
}, - "memo": "string",
- "attachPastDue": true,
- "createdDate": "2019-08-24T14:15:22Z"
}
}Create an invoice and upload a proof of payment simultaneously
Authorizations:
ApiKeyAuth
Request Body schema: multipart/form-datarequired
| invoice | string JSON string containing the invoice data |
| file | string <binary> Proof of Payment file (PDF, JPG, or PNG) |
Responses
Response samples
- 200
- 400
Content type
application/json
{- "message": "string",
- "invoice": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "merchantId": "string",
- "number": "string",
- "dueDate": "2019-08-24T14:15:22Z",
- "status": "DRAFT",
- "total": 0,
- "subTotal": 0,
- "items": [
- {
- "price": 0,
- "quantity": 0,
- "subTotal": 0,
- "total": 0
}
], - "customer": {
- "firstName": "string",
- "lastName": "string",
- "email": "user@example.com",
- "compositeKey": "string"
}, - "memo": "string",
- "attachPastDue": true,
- "createdDate": "2019-08-24T14:15:22Z"
}, - "proof_of_payment": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "invoice_id": "f4c4edb8-11e0-4b33-bcc1-482dc59ebb32",
- "file_name": "string",
- "extension": "string",
- "uploaded": "2019-08-24T14:15:22Z",
- "values": {
- "pop_receiving_account_number": "string",
- "pop_receiving_bank_name": "string",
- "pop_receiving_mobile_number": "string",
- "pop_receiving_name": "string",
- "pop_sending_amount": "string",
- "pop_sending_bank_name": "string",
- "pop_sending_date": "string",
- "pop_sending_name": "string",
- "pop_sending_reference_number": "string",
- "pop_sending_time": "string",
- "account_number": "string",
- "proof_of_payment_bank_name": "string",
- "bank_name": "string",
- "payee_bank": "string",
- "reference_id": "string",
- "total_amount": "string",
- "account_name": "string",
- "date": "string"
}, - "confidence": {
- "pop_receiving_account_number": 0.1,
- "pop_receiving_bank_name": 0.1,
- "pop_receiving_mobile_number": 0.1,
- "pop_receiving_name": 0.1,
- "pop_sending_amount": 0.1,
- "pop_sending_bank_name": 0.1,
- "pop_sending_date": 0.1,
- "pop_sending_name": 0.1,
- "pop_sending_reference_number": 0.1,
- "pop_sending_time": 0.1,
- "account_number": 0.1,
- "proof_of_payment_bank_name": 0.1,
- "bank_name": 0.1,
- "payee_bank": 0.1,
- "reference_id": 0.1,
- "total_amount": 0.1,
- "account_name": 0.1,
- "date": 0.1
}, - "status": "DRAFT"
}
}Upload a proof of payment for an invoice
Authorizations:
ApiKeyAuth
path Parameters
| id required | string <uuid> |
Request Body schema: multipart/form-datarequired
| file | string <binary> Proof of Payment file (PDF, JPG, or PNG) |
Responses
Response samples
- 200
Content type
application/json
{- "document_analysis": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "invoice_id": "f4c4edb8-11e0-4b33-bcc1-482dc59ebb32",
- "file_name": "string",
- "extension": "string",
- "uploaded": "2019-08-24T14:15:22Z",
- "values": {
- "pop_receiving_account_number": "string",
- "pop_receiving_bank_name": "string",
- "pop_receiving_mobile_number": "string",
- "pop_receiving_name": "string",
- "pop_sending_amount": "string",
- "pop_sending_bank_name": "string",
- "pop_sending_date": "string",
- "pop_sending_name": "string",
- "pop_sending_reference_number": "string",
- "pop_sending_time": "string",
- "account_number": "string",
- "proof_of_payment_bank_name": "string",
- "bank_name": "string",
- "payee_bank": "string",
- "reference_id": "string",
- "total_amount": "string",
- "account_name": "string",
- "date": "string"
}, - "confidence": {
- "pop_receiving_account_number": 0.1,
- "pop_receiving_bank_name": 0.1,
- "pop_receiving_mobile_number": 0.1,
- "pop_receiving_name": 0.1,
- "pop_sending_amount": 0.1,
- "pop_sending_bank_name": 0.1,
- "pop_sending_date": 0.1,
- "pop_sending_name": 0.1,
- "pop_sending_reference_number": 0.1,
- "pop_sending_time": 0.1,
- "account_number": 0.1,
- "proof_of_payment_bank_name": 0.1,
- "bank_name": 0.1,
- "payee_bank": 0.1,
- "reference_id": 0.1,
- "total_amount": 0.1,
- "account_name": 0.1,
- "date": 0.1
}, - "status": "DRAFT"
}
}Get all proof of payments for an invoice
Authorizations:
ApiKeyAuth
path Parameters
| id required | string <uuid> |
Responses
Response samples
- 200
Content type
application/json
{- "data": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "invoice_id": "f4c4edb8-11e0-4b33-bcc1-482dc59ebb32",
- "file_name": "string",
- "extension": "string",
- "uploaded": "2019-08-24T14:15:22Z",
- "values": {
- "pop_receiving_account_number": "string",
- "pop_receiving_bank_name": "string",
- "pop_receiving_mobile_number": "string",
- "pop_receiving_name": "string",
- "pop_sending_amount": "string",
- "pop_sending_bank_name": "string",
- "pop_sending_date": "string",
- "pop_sending_name": "string",
- "pop_sending_reference_number": "string",
- "pop_sending_time": "string",
- "account_number": "string",
- "proof_of_payment_bank_name": "string",
- "bank_name": "string",
- "payee_bank": "string",
- "reference_id": "string",
- "total_amount": "string",
- "account_name": "string",
- "date": "string"
}, - "confidence": {
- "pop_receiving_account_number": 0.1,
- "pop_receiving_bank_name": 0.1,
- "pop_receiving_mobile_number": 0.1,
- "pop_receiving_name": 0.1,
- "pop_sending_amount": 0.1,
- "pop_sending_bank_name": 0.1,
- "pop_sending_date": 0.1,
- "pop_sending_name": 0.1,
- "pop_sending_reference_number": 0.1,
- "pop_sending_time": 0.1,
- "account_number": 0.1,
- "proof_of_payment_bank_name": 0.1,
- "bank_name": 0.1,
- "payee_bank": 0.1,
- "reference_id": 0.1,
- "total_amount": 0.1,
- "account_name": 0.1,
- "date": 0.1
}, - "status": "DRAFT"
}
]
}Update proof of payment status and details
Authorizations:
ApiKeyAuth
path Parameters
| id required | string <uuid> |
Request Body schema: application/jsonrequired
Array
| file_name | string |
| pop_receiving_account_number | string |
| pop_receiving_bank_name | string |
| pop_receiving_mobile_number | string |
| pop_receiving_name | string |
| pop_sending_amount | string |
| pop_sending_bank_name | string |
| pop_sending_date | string |
| pop_sending_name | string |
| pop_sending_reference_number | string |
| pop_sending_time | string |
Responses
Request samples
- Payload
Content type
application/json
[- {
- "file_name": "string",
- "pop_receiving_account_number": "string",
- "pop_receiving_bank_name": "string",
- "pop_receiving_mobile_number": "string",
- "pop_receiving_name": "string",
- "pop_sending_amount": "string",
- "pop_sending_bank_name": "string",
- "pop_sending_date": "string",
- "pop_sending_name": "string",
- "pop_sending_reference_number": "string",
- "pop_sending_time": "string"
}
]Response samples
- 200
Content type
application/json
{- "updated": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "invoice_id": "f4c4edb8-11e0-4b33-bcc1-482dc59ebb32",
- "file_name": "string",
- "extension": "string",
- "uploaded": "2019-08-24T14:15:22Z",
- "values": {
- "pop_receiving_account_number": "string",
- "pop_receiving_bank_name": "string",
- "pop_receiving_mobile_number": "string",
- "pop_receiving_name": "string",
- "pop_sending_amount": "string",
- "pop_sending_bank_name": "string",
- "pop_sending_date": "string",
- "pop_sending_name": "string",
- "pop_sending_reference_number": "string",
- "pop_sending_time": "string",
- "account_number": "string",
- "proof_of_payment_bank_name": "string",
- "bank_name": "string",
- "payee_bank": "string",
- "reference_id": "string",
- "total_amount": "string",
- "account_name": "string",
- "date": "string"
}, - "confidence": {
- "pop_receiving_account_number": 0.1,
- "pop_receiving_bank_name": 0.1,
- "pop_receiving_mobile_number": 0.1,
- "pop_receiving_name": 0.1,
- "pop_sending_amount": 0.1,
- "pop_sending_bank_name": 0.1,
- "pop_sending_date": 0.1,
- "pop_sending_name": 0.1,
- "pop_sending_reference_number": 0.1,
- "pop_sending_time": 0.1,
- "account_number": 0.1,
- "proof_of_payment_bank_name": 0.1,
- "bank_name": 0.1,
- "payee_bank": 0.1,
- "reference_id": 0.1,
- "total_amount": 0.1,
- "account_name": 0.1,
- "date": 0.1
}, - "status": "DRAFT"
}
]
}