Import Invoice

POST

https://merchantapi-demo.bill24.io/billflow/v1/Bill24Operation/Invoice/Import

Request

Header Params

Content-Type

string

required

Example:

application/json

string

required

Example:

application/json

Authorization

string

required

Example:

Bearer {{access_token}}

Body Params application/json

array of:

refId

string

optional

Reference ID of bill

refNumber

string

required

Bill number / Invoice number

date

string

required

Bill date

dueDate

string

required

Bill due date

description

string

optional

currency

string

required

Currency code ex: USD or KHR

totalAmount

number

required

Total amount
of Bill

paidAmount

number

optional

Amount to pay

customer

object

required

Customer information

code

string

required

Customer code

name

string

required

Customer name

address

string

optional

Customer's address.

phone

string

optional

Customer’s phone number.

moc

string

optional

Ministry of Commerce registration

vat

string

optional

VAT number for tax purposes

string

optional

Customer’s email address.

totalTax

number

optional

total tax amount.

exchangeRateKhr

number

optional

Exchange rate for converting foreign currency to KHR (Cambodian Riel).

totalAmountKhr

number

optional

Total transaction amount converted to KHR.

details

array [object {6}]

optional

itemName

string

optional

Name of the product or service.

description

string

optional

Additional details about the item.

quantity

number

optional

Number of units purchased.

price

number

optional

Price per unit.

amount

number

optional

Total amount for this item.

taxAmount

number

optional

Tax applied to this item.

Example

[
  {
    "refId": "101",
    "refNumber": "24062101",
    "date": "2024-06-22T02:41:55.350Z",
    "dueDate": "2024-06-30T06:50:55.350Z",
    "description": "upload bills",
    "currency": "USD",
    "totalAmount": 10,
    "paidAmount": 0,
    "customer": {
      "code": "00001",
      "name": "Nim",
      "address": "Phnom Penh",
      "phone": "011345789",
      "moc": "100014",
      "vat": "A102-110003031",
      "email": "testing001@gmail.com"
    },
    "totalTax": 0,
    "exchangeRateKhr": 4120,
    "totalAmountKhr": 41200,
    "details": [
      {
        "itemName": "A001",
        "description": "Hello",
        "quantity": 2,
        "price": 5,
        "amount": 10,
        "taxAmount": 0
      }
    ]
  }
]

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://merchantapi-demo.bill24.io/billflow/v1/Bill24Operation/Invoice/Import' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '[    
{
        "refId": "101",
        "refNumber": "24062101",
        "date": "2024-06-22T02:41:55.350Z",
        "dueDate": "2024-06-30T06:50:55.350Z",
        "description": "upload bills",
        "currency": "USD",
        "totalAmount": 10,
        "paidAmount": 0,
        "customer": {
            "code": "00001",
            "name": "Nim",
            "address": "Phnom Penh",
            "phone": "011345789",
            "moc": "100014",
            "vat": "A102-110003031",
            "email": "testing001@gmail.com"
        },
        "totalTax": 0,
        "exchangeRateKhr": 4120.0,
        "totalAmountKhr": 41200,
        "details": [
            {
                "itemName": "A001",
                "description": "Hello",
                "quantity": 2,
                "price": 5,
                "amount": 10,
                "taxAmount": 0
            }
        ]
    }
]'

Responses

🟢200Success

application/json

Body

string

required

Unique identifier of the record

totalRecord

string

required

Total number of records

status

string

required

Status of the record

Example

{
  "id": 70,
  "totalRecord": 1,
  "status": 1
}

Modified at 2025-03-04 09:12:24

Authorization

Get Transaction