Skip to main content
POST
/
v4
/
core
/
companies
/
{companyId}
/
invoice_payments
Create an invoice payment
curl --request POST \
  --url https://api.integrations.commenda.io/v4/core/companies/{companyId}/invoice_payments \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "data": {
    "platform_id": "string",
    "payment_id": "string",
    "invoice_id": "string",
    "account_id": "string",
    "credit_note_id": "string",
    "amount": 0,
    "payment_mode": "string",
    "currency_id": "AED",
    "currency_rate": 0,
    "document_number": "string",
    "memo": "string",
    "payment_date": "2024-01-01T00:00:00Z",
    "contact_id": "string",
    "updated_at": "2024-01-01T00:00:00Z",
    "invoice": [
      {
        "platform_id": "string",
        "transaction_ids": [
          "string"
        ],
        "order_ids": [
          "string"
        ],
        "sales_order_ids": [
          "string"
        ],
        "contact_id": "string",
        "currency_id": "AED",
        "currency_rate": 0,
        "document_number": "string",
        "posted_date": "2024-01-01T00:00:00Z",
        "due_date": "2024-01-01T00:00:00Z",
        "status": "DRAFT",
        "sub_total": 0,
        "tax_amount": 0,
        "total_discount": 0,
        "shipping_amount": 0,
        "total_amount": 0,
        "amount_paid": 0,
        "amount_refunded": 0,
        "amount_credited": 0,
        "amount_due": 0,
        "memo": "string",
        "subscription_id": "string",
        "payment_link": "string",
        "payment_link_expires_at": "2024-01-01T00:00:00Z",
        "created_at": "2024-01-01T00:00:00Z",
        "updated_at": "2024-01-01T00:00:00Z",
        "line_items": [
          {
            "platform_id": "string",
            "tracking_category_ids": [
              "string"
            ],
            "parent_id": "string",
            "parent_type": "BILL",
            "item_id": "string",
            "name": "string",
            "description": "string",
            "quantity": 0,
            "unit_amount": 0,
            "tax_amount": 0,
            "discount_amount": 0,
            "sub_total": 0,
            "total_amount": 0,
            "tax_id": "string",
            "account_id": "string",
            "variant_id": "string",
            "created_at": "2024-01-01T00:00:00Z",
            "updated_at": "2024-01-01T00:00:00Z"
          }
        ],
        "addresses": [
          {
            "platform_id": "string",
            "parent_id": "string",
            "parent_type": "ACCOUNT",
            "type": "SHIPPING",
            "street": "string",
            "street2": "string",
            "locality": "string",
            "city": "string",
            "state": "string",
            "postal_code": "string",
            "country": "string"
          }
        ]
      }
    ],
    "contact": [
      {
        "platform_id": "string",
        "name": "string",
        "contact_name": "string",
        "email": "string",
        "phone": "string",
        "tax_number": "string",
        "type": "CUSTOMER",
        "status": "ACTIVE",
        "currency_id": "AED",
        "registration_number": "string",
        "website": "string",
        "created_at": "2024-01-01T00:00:00Z",
        "updated_at": "2024-01-01T00:00:00Z",
        "addresses": [
          {
            "platform_id": "string",
            "parent_id": "string",
            "parent_type": "ACCOUNT",
            "type": "SHIPPING",
            "street": "string",
            "street2": "string",
            "locality": "string",
            "city": "string",
            "state": "string",
            "postal_code": "string",
            "country": "string"
          }
        ],
        "phone_numbers": [
          {
            "platform_id": "string",
            "parent_id": "string",
            "parent_type": "ACCOUNT",
            "number": "string",
            "type": "MOBILE"
          }
        ],
        "external_links": [
          {
            "platform_id": "string",
            "parent_id": "string",
            "parent_type": "ACCOUNT",
            "link": "string",
            "type": "WEBSITE"
          }
        ]
      }
    ],
    "currency": [
      {
        "platform_id": "string",
        "name": "string",
        "code": "string",
        "symbol": "string",
        "is_base_currency": false,
        "exchange_rate": 0,
        "updated_at": "2024-01-01T00:00:00Z"
      }
    ],
    "account": [
      {
        "platform_id": "string",
        "nominal_code": "string",
        "name": "string",
        "description": "string",
        "currency_id": "AED",
        "current_balance": 0,
        "status": "ACTIVE",
        "category": "ASSET",
        "sub_category": "string",
        "parent_account_id": "string",
        "updated_at": "2024-01-01T00:00:00Z"
      }
    ]
  }
}
'
import requests

url = "https://api.integrations.commenda.io/v4/core/companies/{companyId}/invoice_payments"

payload = { "data": {
        "platform_id": "string",
        "payment_id": "string",
        "invoice_id": "string",
        "account_id": "string",
        "credit_note_id": "string",
        "amount": 0,
        "payment_mode": "string",
        "currency_id": "AED",
        "currency_rate": 0,
        "document_number": "string",
        "memo": "string",
        "payment_date": "2024-01-01T00:00:00Z",
        "contact_id": "string",
        "updated_at": "2024-01-01T00:00:00Z",
        "invoice": [
            {
                "platform_id": "string",
                "transaction_ids": ["string"],
                "order_ids": ["string"],
                "sales_order_ids": ["string"],
                "contact_id": "string",
                "currency_id": "AED",
                "currency_rate": 0,
                "document_number": "string",
                "posted_date": "2024-01-01T00:00:00Z",
                "due_date": "2024-01-01T00:00:00Z",
                "status": "DRAFT",
                "sub_total": 0,
                "tax_amount": 0,
                "total_discount": 0,
                "shipping_amount": 0,
                "total_amount": 0,
                "amount_paid": 0,
                "amount_refunded": 0,
                "amount_credited": 0,
                "amount_due": 0,
                "memo": "string",
                "subscription_id": "string",
                "payment_link": "string",
                "payment_link_expires_at": "2024-01-01T00:00:00Z",
                "created_at": "2024-01-01T00:00:00Z",
                "updated_at": "2024-01-01T00:00:00Z",
                "line_items": [
                    {
                        "platform_id": "string",
                        "tracking_category_ids": ["string"],
                        "parent_id": "string",
                        "parent_type": "BILL",
                        "item_id": "string",
                        "name": "string",
                        "description": "string",
                        "quantity": 0,
                        "unit_amount": 0,
                        "tax_amount": 0,
                        "discount_amount": 0,
                        "sub_total": 0,
                        "total_amount": 0,
                        "tax_id": "string",
                        "account_id": "string",
                        "variant_id": "string",
                        "created_at": "2024-01-01T00:00:00Z",
                        "updated_at": "2024-01-01T00:00:00Z"
                    }
                ],
                "addresses": [
                    {
                        "platform_id": "string",
                        "parent_id": "string",
                        "parent_type": "ACCOUNT",
                        "type": "SHIPPING",
                        "street": "string",
                        "street2": "string",
                        "locality": "string",
                        "city": "string",
                        "state": "string",
                        "postal_code": "string",
                        "country": "string"
                    }
                ]
            }
        ],
        "contact": [
            {
                "platform_id": "string",
                "name": "string",
                "contact_name": "string",
                "email": "string",
                "phone": "string",
                "tax_number": "string",
                "type": "CUSTOMER",
                "status": "ACTIVE",
                "currency_id": "AED",
                "registration_number": "string",
                "website": "string",
                "created_at": "2024-01-01T00:00:00Z",
                "updated_at": "2024-01-01T00:00:00Z",
                "addresses": [
                    {
                        "platform_id": "string",
                        "parent_id": "string",
                        "parent_type": "ACCOUNT",
                        "type": "SHIPPING",
                        "street": "string",
                        "street2": "string",
                        "locality": "string",
                        "city": "string",
                        "state": "string",
                        "postal_code": "string",
                        "country": "string"
                    }
                ],
                "phone_numbers": [
                    {
                        "platform_id": "string",
                        "parent_id": "string",
                        "parent_type": "ACCOUNT",
                        "number": "string",
                        "type": "MOBILE"
                    }
                ],
                "external_links": [
                    {
                        "platform_id": "string",
                        "parent_id": "string",
                        "parent_type": "ACCOUNT",
                        "link": "string",
                        "type": "WEBSITE"
                    }
                ]
            }
        ],
        "currency": [
            {
                "platform_id": "string",
                "name": "string",
                "code": "string",
                "symbol": "string",
                "is_base_currency": False,
                "exchange_rate": 0,
                "updated_at": "2024-01-01T00:00:00Z"
            }
        ],
        "account": [
            {
                "platform_id": "string",
                "nominal_code": "string",
                "name": "string",
                "description": "string",
                "currency_id": "AED",
                "current_balance": 0,
                "status": "ACTIVE",
                "category": "ASSET",
                "sub_category": "string",
                "parent_account_id": "string",
                "updated_at": "2024-01-01T00:00:00Z"
            }
        ]
    } }
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    data: {
      platform_id: 'string',
      payment_id: 'string',
      invoice_id: 'string',
      account_id: 'string',
      credit_note_id: 'string',
      amount: 0,
      payment_mode: 'string',
      currency_id: 'AED',
      currency_rate: 0,
      document_number: 'string',
      memo: 'string',
      payment_date: '2024-01-01T00:00:00Z',
      contact_id: 'string',
      updated_at: '2024-01-01T00:00:00Z',
      invoice: [
        {
          platform_id: 'string',
          transaction_ids: ['string'],
          order_ids: ['string'],
          sales_order_ids: ['string'],
          contact_id: 'string',
          currency_id: 'AED',
          currency_rate: 0,
          document_number: 'string',
          posted_date: '2024-01-01T00:00:00Z',
          due_date: '2024-01-01T00:00:00Z',
          status: 'DRAFT',
          sub_total: 0,
          tax_amount: 0,
          total_discount: 0,
          shipping_amount: 0,
          total_amount: 0,
          amount_paid: 0,
          amount_refunded: 0,
          amount_credited: 0,
          amount_due: 0,
          memo: 'string',
          subscription_id: 'string',
          payment_link: 'string',
          payment_link_expires_at: '2024-01-01T00:00:00Z',
          created_at: '2024-01-01T00:00:00Z',
          updated_at: '2024-01-01T00:00:00Z',
          line_items: [
            {
              platform_id: 'string',
              tracking_category_ids: ['string'],
              parent_id: 'string',
              parent_type: 'BILL',
              item_id: 'string',
              name: 'string',
              description: 'string',
              quantity: 0,
              unit_amount: 0,
              tax_amount: 0,
              discount_amount: 0,
              sub_total: 0,
              total_amount: 0,
              tax_id: 'string',
              account_id: 'string',
              variant_id: 'string',
              created_at: '2024-01-01T00:00:00Z',
              updated_at: '2024-01-01T00:00:00Z'
            }
          ],
          addresses: [
            {
              platform_id: 'string',
              parent_id: 'string',
              parent_type: 'ACCOUNT',
              type: 'SHIPPING',
              street: 'string',
              street2: 'string',
              locality: 'string',
              city: 'string',
              state: 'string',
              postal_code: 'string',
              country: 'string'
            }
          ]
        }
      ],
      contact: [
        {
          platform_id: 'string',
          name: 'string',
          contact_name: 'string',
          email: 'string',
          phone: 'string',
          tax_number: 'string',
          type: 'CUSTOMER',
          status: 'ACTIVE',
          currency_id: 'AED',
          registration_number: 'string',
          website: 'string',
          created_at: '2024-01-01T00:00:00Z',
          updated_at: '2024-01-01T00:00:00Z',
          addresses: [
            {
              platform_id: 'string',
              parent_id: 'string',
              parent_type: 'ACCOUNT',
              type: 'SHIPPING',
              street: 'string',
              street2: 'string',
              locality: 'string',
              city: 'string',
              state: 'string',
              postal_code: 'string',
              country: 'string'
            }
          ],
          phone_numbers: [
            {
              platform_id: 'string',
              parent_id: 'string',
              parent_type: 'ACCOUNT',
              number: 'string',
              type: 'MOBILE'
            }
          ],
          external_links: [
            {
              platform_id: 'string',
              parent_id: 'string',
              parent_type: 'ACCOUNT',
              link: 'string',
              type: 'WEBSITE'
            }
          ]
        }
      ],
      currency: [
        {
          platform_id: 'string',
          name: 'string',
          code: 'string',
          symbol: 'string',
          is_base_currency: false,
          exchange_rate: 0,
          updated_at: '2024-01-01T00:00:00Z'
        }
      ],
      account: [
        {
          platform_id: 'string',
          nominal_code: 'string',
          name: 'string',
          description: 'string',
          currency_id: 'AED',
          current_balance: 0,
          status: 'ACTIVE',
          category: 'ASSET',
          sub_category: 'string',
          parent_account_id: 'string',
          updated_at: '2024-01-01T00:00:00Z'
        }
      ]
    }
  })
};

fetch('https://api.integrations.commenda.io/v4/core/companies/{companyId}/invoice_payments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.integrations.commenda.io/v4/core/companies/{companyId}/invoice_payments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'data' => [
        'platform_id' => 'string',
        'payment_id' => 'string',
        'invoice_id' => 'string',
        'account_id' => 'string',
        'credit_note_id' => 'string',
        'amount' => 0,
        'payment_mode' => 'string',
        'currency_id' => 'AED',
        'currency_rate' => 0,
        'document_number' => 'string',
        'memo' => 'string',
        'payment_date' => '2024-01-01T00:00:00Z',
        'contact_id' => 'string',
        'updated_at' => '2024-01-01T00:00:00Z',
        'invoice' => [
                [
                                'platform_id' => 'string',
                                'transaction_ids' => [
                                                                'string'
                                ],
                                'order_ids' => [
                                                                'string'
                                ],
                                'sales_order_ids' => [
                                                                'string'
                                ],
                                'contact_id' => 'string',
                                'currency_id' => 'AED',
                                'currency_rate' => 0,
                                'document_number' => 'string',
                                'posted_date' => '2024-01-01T00:00:00Z',
                                'due_date' => '2024-01-01T00:00:00Z',
                                'status' => 'DRAFT',
                                'sub_total' => 0,
                                'tax_amount' => 0,
                                'total_discount' => 0,
                                'shipping_amount' => 0,
                                'total_amount' => 0,
                                'amount_paid' => 0,
                                'amount_refunded' => 0,
                                'amount_credited' => 0,
                                'amount_due' => 0,
                                'memo' => 'string',
                                'subscription_id' => 'string',
                                'payment_link' => 'string',
                                'payment_link_expires_at' => '2024-01-01T00:00:00Z',
                                'created_at' => '2024-01-01T00:00:00Z',
                                'updated_at' => '2024-01-01T00:00:00Z',
                                'line_items' => [
                                                                [
                                                                                                                                'platform_id' => 'string',
                                                                                                                                'tracking_category_ids' => [
                                                                                                                                                                                                                                                                'string'
                                                                                                                                ],
                                                                                                                                'parent_id' => 'string',
                                                                                                                                'parent_type' => 'BILL',
                                                                                                                                'item_id' => 'string',
                                                                                                                                'name' => 'string',
                                                                                                                                'description' => 'string',
                                                                                                                                'quantity' => 0,
                                                                                                                                'unit_amount' => 0,
                                                                                                                                'tax_amount' => 0,
                                                                                                                                'discount_amount' => 0,
                                                                                                                                'sub_total' => 0,
                                                                                                                                'total_amount' => 0,
                                                                                                                                'tax_id' => 'string',
                                                                                                                                'account_id' => 'string',
                                                                                                                                'variant_id' => 'string',
                                                                                                                                'created_at' => '2024-01-01T00:00:00Z',
                                                                                                                                'updated_at' => '2024-01-01T00:00:00Z'
                                                                ]
                                ],
                                'addresses' => [
                                                                [
                                                                                                                                'platform_id' => 'string',
                                                                                                                                'parent_id' => 'string',
                                                                                                                                'parent_type' => 'ACCOUNT',
                                                                                                                                'type' => 'SHIPPING',
                                                                                                                                'street' => 'string',
                                                                                                                                'street2' => 'string',
                                                                                                                                'locality' => 'string',
                                                                                                                                'city' => 'string',
                                                                                                                                'state' => 'string',
                                                                                                                                'postal_code' => 'string',
                                                                                                                                'country' => 'string'
                                                                ]
                                ]
                ]
        ],
        'contact' => [
                [
                                'platform_id' => 'string',
                                'name' => 'string',
                                'contact_name' => 'string',
                                'email' => 'string',
                                'phone' => 'string',
                                'tax_number' => 'string',
                                'type' => 'CUSTOMER',
                                'status' => 'ACTIVE',
                                'currency_id' => 'AED',
                                'registration_number' => 'string',
                                'website' => 'string',
                                'created_at' => '2024-01-01T00:00:00Z',
                                'updated_at' => '2024-01-01T00:00:00Z',
                                'addresses' => [
                                                                [
                                                                                                                                'platform_id' => 'string',
                                                                                                                                'parent_id' => 'string',
                                                                                                                                'parent_type' => 'ACCOUNT',
                                                                                                                                'type' => 'SHIPPING',
                                                                                                                                'street' => 'string',
                                                                                                                                'street2' => 'string',
                                                                                                                                'locality' => 'string',
                                                                                                                                'city' => 'string',
                                                                                                                                'state' => 'string',
                                                                                                                                'postal_code' => 'string',
                                                                                                                                'country' => 'string'
                                                                ]
                                ],
                                'phone_numbers' => [
                                                                [
                                                                                                                                'platform_id' => 'string',
                                                                                                                                'parent_id' => 'string',
                                                                                                                                'parent_type' => 'ACCOUNT',
                                                                                                                                'number' => 'string',
                                                                                                                                'type' => 'MOBILE'
                                                                ]
                                ],
                                'external_links' => [
                                                                [
                                                                                                                                'platform_id' => 'string',
                                                                                                                                'parent_id' => 'string',
                                                                                                                                'parent_type' => 'ACCOUNT',
                                                                                                                                'link' => 'string',
                                                                                                                                'type' => 'WEBSITE'
                                                                ]
                                ]
                ]
        ],
        'currency' => [
                [
                                'platform_id' => 'string',
                                'name' => 'string',
                                'code' => 'string',
                                'symbol' => 'string',
                                'is_base_currency' => false,
                                'exchange_rate' => 0,
                                'updated_at' => '2024-01-01T00:00:00Z'
                ]
        ],
        'account' => [
                [
                                'platform_id' => 'string',
                                'nominal_code' => 'string',
                                'name' => 'string',
                                'description' => 'string',
                                'currency_id' => 'AED',
                                'current_balance' => 0,
                                'status' => 'ACTIVE',
                                'category' => 'ASSET',
                                'sub_category' => 'string',
                                'parent_account_id' => 'string',
                                'updated_at' => '2024-01-01T00:00:00Z'
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.integrations.commenda.io/v4/core/companies/{companyId}/invoice_payments"

	payload := strings.NewReader("{\n  \"data\": {\n    \"platform_id\": \"string\",\n    \"payment_id\": \"string\",\n    \"invoice_id\": \"string\",\n    \"account_id\": \"string\",\n    \"credit_note_id\": \"string\",\n    \"amount\": 0,\n    \"payment_mode\": \"string\",\n    \"currency_id\": \"AED\",\n    \"currency_rate\": 0,\n    \"document_number\": \"string\",\n    \"memo\": \"string\",\n    \"payment_date\": \"2024-01-01T00:00:00Z\",\n    \"contact_id\": \"string\",\n    \"updated_at\": \"2024-01-01T00:00:00Z\",\n    \"invoice\": [\n      {\n        \"platform_id\": \"string\",\n        \"transaction_ids\": [\n          \"string\"\n        ],\n        \"order_ids\": [\n          \"string\"\n        ],\n        \"sales_order_ids\": [\n          \"string\"\n        ],\n        \"contact_id\": \"string\",\n        \"currency_id\": \"AED\",\n        \"currency_rate\": 0,\n        \"document_number\": \"string\",\n        \"posted_date\": \"2024-01-01T00:00:00Z\",\n        \"due_date\": \"2024-01-01T00:00:00Z\",\n        \"status\": \"DRAFT\",\n        \"sub_total\": 0,\n        \"tax_amount\": 0,\n        \"total_discount\": 0,\n        \"shipping_amount\": 0,\n        \"total_amount\": 0,\n        \"amount_paid\": 0,\n        \"amount_refunded\": 0,\n        \"amount_credited\": 0,\n        \"amount_due\": 0,\n        \"memo\": \"string\",\n        \"subscription_id\": \"string\",\n        \"payment_link\": \"string\",\n        \"payment_link_expires_at\": \"2024-01-01T00:00:00Z\",\n        \"created_at\": \"2024-01-01T00:00:00Z\",\n        \"updated_at\": \"2024-01-01T00:00:00Z\",\n        \"line_items\": [\n          {\n            \"platform_id\": \"string\",\n            \"tracking_category_ids\": [\n              \"string\"\n            ],\n            \"parent_id\": \"string\",\n            \"parent_type\": \"BILL\",\n            \"item_id\": \"string\",\n            \"name\": \"string\",\n            \"description\": \"string\",\n            \"quantity\": 0,\n            \"unit_amount\": 0,\n            \"tax_amount\": 0,\n            \"discount_amount\": 0,\n            \"sub_total\": 0,\n            \"total_amount\": 0,\n            \"tax_id\": \"string\",\n            \"account_id\": \"string\",\n            \"variant_id\": \"string\",\n            \"created_at\": \"2024-01-01T00:00:00Z\",\n            \"updated_at\": \"2024-01-01T00:00:00Z\"\n          }\n        ],\n        \"addresses\": [\n          {\n            \"platform_id\": \"string\",\n            \"parent_id\": \"string\",\n            \"parent_type\": \"ACCOUNT\",\n            \"type\": \"SHIPPING\",\n            \"street\": \"string\",\n            \"street2\": \"string\",\n            \"locality\": \"string\",\n            \"city\": \"string\",\n            \"state\": \"string\",\n            \"postal_code\": \"string\",\n            \"country\": \"string\"\n          }\n        ]\n      }\n    ],\n    \"contact\": [\n      {\n        \"platform_id\": \"string\",\n        \"name\": \"string\",\n        \"contact_name\": \"string\",\n        \"email\": \"string\",\n        \"phone\": \"string\",\n        \"tax_number\": \"string\",\n        \"type\": \"CUSTOMER\",\n        \"status\": \"ACTIVE\",\n        \"currency_id\": \"AED\",\n        \"registration_number\": \"string\",\n        \"website\": \"string\",\n        \"created_at\": \"2024-01-01T00:00:00Z\",\n        \"updated_at\": \"2024-01-01T00:00:00Z\",\n        \"addresses\": [\n          {\n            \"platform_id\": \"string\",\n            \"parent_id\": \"string\",\n            \"parent_type\": \"ACCOUNT\",\n            \"type\": \"SHIPPING\",\n            \"street\": \"string\",\n            \"street2\": \"string\",\n            \"locality\": \"string\",\n            \"city\": \"string\",\n            \"state\": \"string\",\n            \"postal_code\": \"string\",\n            \"country\": \"string\"\n          }\n        ],\n        \"phone_numbers\": [\n          {\n            \"platform_id\": \"string\",\n            \"parent_id\": \"string\",\n            \"parent_type\": \"ACCOUNT\",\n            \"number\": \"string\",\n            \"type\": \"MOBILE\"\n          }\n        ],\n        \"external_links\": [\n          {\n            \"platform_id\": \"string\",\n            \"parent_id\": \"string\",\n            \"parent_type\": \"ACCOUNT\",\n            \"link\": \"string\",\n            \"type\": \"WEBSITE\"\n          }\n        ]\n      }\n    ],\n    \"currency\": [\n      {\n        \"platform_id\": \"string\",\n        \"name\": \"string\",\n        \"code\": \"string\",\n        \"symbol\": \"string\",\n        \"is_base_currency\": false,\n        \"exchange_rate\": 0,\n        \"updated_at\": \"2024-01-01T00:00:00Z\"\n      }\n    ],\n    \"account\": [\n      {\n        \"platform_id\": \"string\",\n        \"nominal_code\": \"string\",\n        \"name\": \"string\",\n        \"description\": \"string\",\n        \"currency_id\": \"AED\",\n        \"current_balance\": 0,\n        \"status\": \"ACTIVE\",\n        \"category\": \"ASSET\",\n        \"sub_category\": \"string\",\n        \"parent_account_id\": \"string\",\n        \"updated_at\": \"2024-01-01T00:00:00Z\"\n      }\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.integrations.commenda.io/v4/core/companies/{companyId}/invoice_payments")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": {\n    \"platform_id\": \"string\",\n    \"payment_id\": \"string\",\n    \"invoice_id\": \"string\",\n    \"account_id\": \"string\",\n    \"credit_note_id\": \"string\",\n    \"amount\": 0,\n    \"payment_mode\": \"string\",\n    \"currency_id\": \"AED\",\n    \"currency_rate\": 0,\n    \"document_number\": \"string\",\n    \"memo\": \"string\",\n    \"payment_date\": \"2024-01-01T00:00:00Z\",\n    \"contact_id\": \"string\",\n    \"updated_at\": \"2024-01-01T00:00:00Z\",\n    \"invoice\": [\n      {\n        \"platform_id\": \"string\",\n        \"transaction_ids\": [\n          \"string\"\n        ],\n        \"order_ids\": [\n          \"string\"\n        ],\n        \"sales_order_ids\": [\n          \"string\"\n        ],\n        \"contact_id\": \"string\",\n        \"currency_id\": \"AED\",\n        \"currency_rate\": 0,\n        \"document_number\": \"string\",\n        \"posted_date\": \"2024-01-01T00:00:00Z\",\n        \"due_date\": \"2024-01-01T00:00:00Z\",\n        \"status\": \"DRAFT\",\n        \"sub_total\": 0,\n        \"tax_amount\": 0,\n        \"total_discount\": 0,\n        \"shipping_amount\": 0,\n        \"total_amount\": 0,\n        \"amount_paid\": 0,\n        \"amount_refunded\": 0,\n        \"amount_credited\": 0,\n        \"amount_due\": 0,\n        \"memo\": \"string\",\n        \"subscription_id\": \"string\",\n        \"payment_link\": \"string\",\n        \"payment_link_expires_at\": \"2024-01-01T00:00:00Z\",\n        \"created_at\": \"2024-01-01T00:00:00Z\",\n        \"updated_at\": \"2024-01-01T00:00:00Z\",\n        \"line_items\": [\n          {\n            \"platform_id\": \"string\",\n            \"tracking_category_ids\": [\n              \"string\"\n            ],\n            \"parent_id\": \"string\",\n            \"parent_type\": \"BILL\",\n            \"item_id\": \"string\",\n            \"name\": \"string\",\n            \"description\": \"string\",\n            \"quantity\": 0,\n            \"unit_amount\": 0,\n            \"tax_amount\": 0,\n            \"discount_amount\": 0,\n            \"sub_total\": 0,\n            \"total_amount\": 0,\n            \"tax_id\": \"string\",\n            \"account_id\": \"string\",\n            \"variant_id\": \"string\",\n            \"created_at\": \"2024-01-01T00:00:00Z\",\n            \"updated_at\": \"2024-01-01T00:00:00Z\"\n          }\n        ],\n        \"addresses\": [\n          {\n            \"platform_id\": \"string\",\n            \"parent_id\": \"string\",\n            \"parent_type\": \"ACCOUNT\",\n            \"type\": \"SHIPPING\",\n            \"street\": \"string\",\n            \"street2\": \"string\",\n            \"locality\": \"string\",\n            \"city\": \"string\",\n            \"state\": \"string\",\n            \"postal_code\": \"string\",\n            \"country\": \"string\"\n          }\n        ]\n      }\n    ],\n    \"contact\": [\n      {\n        \"platform_id\": \"string\",\n        \"name\": \"string\",\n        \"contact_name\": \"string\",\n        \"email\": \"string\",\n        \"phone\": \"string\",\n        \"tax_number\": \"string\",\n        \"type\": \"CUSTOMER\",\n        \"status\": \"ACTIVE\",\n        \"currency_id\": \"AED\",\n        \"registration_number\": \"string\",\n        \"website\": \"string\",\n        \"created_at\": \"2024-01-01T00:00:00Z\",\n        \"updated_at\": \"2024-01-01T00:00:00Z\",\n        \"addresses\": [\n          {\n            \"platform_id\": \"string\",\n            \"parent_id\": \"string\",\n            \"parent_type\": \"ACCOUNT\",\n            \"type\": \"SHIPPING\",\n            \"street\": \"string\",\n            \"street2\": \"string\",\n            \"locality\": \"string\",\n            \"city\": \"string\",\n            \"state\": \"string\",\n            \"postal_code\": \"string\",\n            \"country\": \"string\"\n          }\n        ],\n        \"phone_numbers\": [\n          {\n            \"platform_id\": \"string\",\n            \"parent_id\": \"string\",\n            \"parent_type\": \"ACCOUNT\",\n            \"number\": \"string\",\n            \"type\": \"MOBILE\"\n          }\n        ],\n        \"external_links\": [\n          {\n            \"platform_id\": \"string\",\n            \"parent_id\": \"string\",\n            \"parent_type\": \"ACCOUNT\",\n            \"link\": \"string\",\n            \"type\": \"WEBSITE\"\n          }\n        ]\n      }\n    ],\n    \"currency\": [\n      {\n        \"platform_id\": \"string\",\n        \"name\": \"string\",\n        \"code\": \"string\",\n        \"symbol\": \"string\",\n        \"is_base_currency\": false,\n        \"exchange_rate\": 0,\n        \"updated_at\": \"2024-01-01T00:00:00Z\"\n      }\n    ],\n    \"account\": [\n      {\n        \"platform_id\": \"string\",\n        \"nominal_code\": \"string\",\n        \"name\": \"string\",\n        \"description\": \"string\",\n        \"currency_id\": \"AED\",\n        \"current_balance\": 0,\n        \"status\": \"ACTIVE\",\n        \"category\": \"ASSET\",\n        \"sub_category\": \"string\",\n        \"parent_account_id\": \"string\",\n        \"updated_at\": \"2024-01-01T00:00:00Z\"\n      }\n    ]\n  }\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.integrations.commenda.io/v4/core/companies/{companyId}/invoice_payments")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"data\": {\n    \"platform_id\": \"string\",\n    \"payment_id\": \"string\",\n    \"invoice_id\": \"string\",\n    \"account_id\": \"string\",\n    \"credit_note_id\": \"string\",\n    \"amount\": 0,\n    \"payment_mode\": \"string\",\n    \"currency_id\": \"AED\",\n    \"currency_rate\": 0,\n    \"document_number\": \"string\",\n    \"memo\": \"string\",\n    \"payment_date\": \"2024-01-01T00:00:00Z\",\n    \"contact_id\": \"string\",\n    \"updated_at\": \"2024-01-01T00:00:00Z\",\n    \"invoice\": [\n      {\n        \"platform_id\": \"string\",\n        \"transaction_ids\": [\n          \"string\"\n        ],\n        \"order_ids\": [\n          \"string\"\n        ],\n        \"sales_order_ids\": [\n          \"string\"\n        ],\n        \"contact_id\": \"string\",\n        \"currency_id\": \"AED\",\n        \"currency_rate\": 0,\n        \"document_number\": \"string\",\n        \"posted_date\": \"2024-01-01T00:00:00Z\",\n        \"due_date\": \"2024-01-01T00:00:00Z\",\n        \"status\": \"DRAFT\",\n        \"sub_total\": 0,\n        \"tax_amount\": 0,\n        \"total_discount\": 0,\n        \"shipping_amount\": 0,\n        \"total_amount\": 0,\n        \"amount_paid\": 0,\n        \"amount_refunded\": 0,\n        \"amount_credited\": 0,\n        \"amount_due\": 0,\n        \"memo\": \"string\",\n        \"subscription_id\": \"string\",\n        \"payment_link\": \"string\",\n        \"payment_link_expires_at\": \"2024-01-01T00:00:00Z\",\n        \"created_at\": \"2024-01-01T00:00:00Z\",\n        \"updated_at\": \"2024-01-01T00:00:00Z\",\n        \"line_items\": [\n          {\n            \"platform_id\": \"string\",\n            \"tracking_category_ids\": [\n              \"string\"\n            ],\n            \"parent_id\": \"string\",\n            \"parent_type\": \"BILL\",\n            \"item_id\": \"string\",\n            \"name\": \"string\",\n            \"description\": \"string\",\n            \"quantity\": 0,\n            \"unit_amount\": 0,\n            \"tax_amount\": 0,\n            \"discount_amount\": 0,\n            \"sub_total\": 0,\n            \"total_amount\": 0,\n            \"tax_id\": \"string\",\n            \"account_id\": \"string\",\n            \"variant_id\": \"string\",\n            \"created_at\": \"2024-01-01T00:00:00Z\",\n            \"updated_at\": \"2024-01-01T00:00:00Z\"\n          }\n        ],\n        \"addresses\": [\n          {\n            \"platform_id\": \"string\",\n            \"parent_id\": \"string\",\n            \"parent_type\": \"ACCOUNT\",\n            \"type\": \"SHIPPING\",\n            \"street\": \"string\",\n            \"street2\": \"string\",\n            \"locality\": \"string\",\n            \"city\": \"string\",\n            \"state\": \"string\",\n            \"postal_code\": \"string\",\n            \"country\": \"string\"\n          }\n        ]\n      }\n    ],\n    \"contact\": [\n      {\n        \"platform_id\": \"string\",\n        \"name\": \"string\",\n        \"contact_name\": \"string\",\n        \"email\": \"string\",\n        \"phone\": \"string\",\n        \"tax_number\": \"string\",\n        \"type\": \"CUSTOMER\",\n        \"status\": \"ACTIVE\",\n        \"currency_id\": \"AED\",\n        \"registration_number\": \"string\",\n        \"website\": \"string\",\n        \"created_at\": \"2024-01-01T00:00:00Z\",\n        \"updated_at\": \"2024-01-01T00:00:00Z\",\n        \"addresses\": [\n          {\n            \"platform_id\": \"string\",\n            \"parent_id\": \"string\",\n            \"parent_type\": \"ACCOUNT\",\n            \"type\": \"SHIPPING\",\n            \"street\": \"string\",\n            \"street2\": \"string\",\n            \"locality\": \"string\",\n            \"city\": \"string\",\n            \"state\": \"string\",\n            \"postal_code\": \"string\",\n            \"country\": \"string\"\n          }\n        ],\n        \"phone_numbers\": [\n          {\n            \"platform_id\": \"string\",\n            \"parent_id\": \"string\",\n            \"parent_type\": \"ACCOUNT\",\n            \"number\": \"string\",\n            \"type\": \"MOBILE\"\n          }\n        ],\n        \"external_links\": [\n          {\n            \"platform_id\": \"string\",\n            \"parent_id\": \"string\",\n            \"parent_type\": \"ACCOUNT\",\n            \"link\": \"string\",\n            \"type\": \"WEBSITE\"\n          }\n        ]\n      }\n    ],\n    \"currency\": [\n      {\n        \"platform_id\": \"string\",\n        \"name\": \"string\",\n        \"code\": \"string\",\n        \"symbol\": \"string\",\n        \"is_base_currency\": false,\n        \"exchange_rate\": 0,\n        \"updated_at\": \"2024-01-01T00:00:00Z\"\n      }\n    ],\n    \"account\": [\n      {\n        \"platform_id\": \"string\",\n        \"nominal_code\": \"string\",\n        \"name\": \"string\",\n        \"description\": \"string\",\n        \"currency_id\": \"AED\",\n        \"current_balance\": 0,\n        \"status\": \"ACTIVE\",\n        \"category\": \"ASSET\",\n        \"sub_category\": \"string\",\n        \"parent_account_id\": \"string\",\n        \"updated_at\": \"2024-01-01T00:00:00Z\"\n      }\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body
{
  "data": {
    "sync_id": "<string>",
    "data": {
      "rootfi_id": 123,
      "rootfi_created_at": "2023-11-07T05:31:56Z",
      "rootfi_updated_at": "2023-11-07T05:31:56Z",
      "platform_id": "<string>",
      "payment_id": "<string>",
      "invoice_id": "<string>",
      "account_id": "<string>",
      "credit_note_id": "<string>",
      "amount": 123,
      "payment_mode": "<string>",
      "currency_rate": 123,
      "document_number": "<string>",
      "memo": "<string>",
      "payment_date": "2023-11-07T05:31:56Z",
      "contact_id": "<string>",
      "updated_at": "2023-11-07T05:31:56Z",
      "invoice": [
        {
          "rootfi_id": 123,
          "rootfi_created_at": "2023-11-07T05:31:56Z",
          "rootfi_updated_at": "2023-11-07T05:31:56Z",
          "platform_id": "<string>",
          "transaction_ids": [
            "<string>"
          ],
          "order_ids": [
            "<string>"
          ],
          "sales_order_ids": [
            "<string>"
          ],
          "contact_id": "<string>",
          "currency_rate": 123,
          "document_number": "<string>",
          "posted_date": "2023-11-07T05:31:56Z",
          "due_date": "2023-11-07T05:31:56Z",
          "sub_total": 123,
          "tax_amount": 123,
          "total_discount": 123,
          "shipping_amount": 123,
          "total_amount": 123,
          "amount_paid": 123,
          "amount_refunded": 123,
          "amount_credited": 123,
          "amount_due": 123,
          "memo": "<string>",
          "subscription_id": "<string>",
          "payment_link": "<string>",
          "payment_link_expires_at": "2023-11-07T05:31:56Z",
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z",
          "line_items": [
            {
              "rootfi_id": 123,
              "rootfi_created_at": "2023-11-07T05:31:56Z",
              "rootfi_updated_at": "2023-11-07T05:31:56Z",
              "platform_id": "<string>",
              "tracking_category_ids": [
                "<string>"
              ],
              "parent_id": "<string>",
              "item_id": "<string>",
              "name": "<string>",
              "description": "<string>",
              "quantity": 123,
              "unit_amount": 123,
              "tax_amount": 123,
              "discount_amount": 123,
              "sub_total": 123,
              "total_amount": 123,
              "tax_id": "<string>",
              "account_id": "<string>",
              "variant_id": "<string>",
              "created_at": "2023-11-07T05:31:56Z",
              "updated_at": "2023-11-07T05:31:56Z",
              "item": [
                {
                  "rootfi_id": 123,
                  "rootfi_created_at": "2023-11-07T05:31:56Z",
                  "rootfi_updated_at": "2023-11-07T05:31:56Z",
                  "platform_id": "<string>",
                  "name": "<string>",
                  "description": "<string>",
                  "code": "<string>",
                  "sku": "<string>",
                  "price": 123,
                  "quantity_on_hand": 123,
                  "is_bill_item": true,
                  "bill_item": "<unknown>",
                  "is_invoice_item": true,
                  "invoice_item": "<unknown>",
                  "created_at": "2023-11-07T05:31:56Z",
                  "updated_at": "2023-11-07T05:31:56Z",
                  "variants": [
                    {
                      "rootfi_id": 123,
                      "rootfi_created_at": "2023-11-07T05:31:56Z",
                      "rootfi_updated_at": "2023-11-07T05:31:56Z",
                      "platform_id": "<string>",
                      "parent_id": "<string>",
                      "name": "<string>",
                      "sku": "<string>",
                      "price": 123,
                      "compare_at_price": 123,
                      "attributes": "<unknown>"
                    }
                  ]
                }
              ],
              "tax": [
                {
                  "rootfi_id": 123,
                  "rootfi_created_at": "2023-11-07T05:31:56Z",
                  "rootfi_updated_at": "2023-11-07T05:31:56Z",
                  "platform_id": "<string>",
                  "name": "<string>",
                  "code": "<string>",
                  "rate": 123,
                  "tax_type": "<string>",
                  "effective_tax_rate": 123,
                  "total_tax_rate": 123,
                  "components": "<unknown>",
                  "jurisdiction": "<string>",
                  "created_at": "2023-11-07T05:31:56Z",
                  "updated_at": "2023-11-07T05:31:56Z"
                }
              ],
              "account": [
                {
                  "rootfi_id": 123,
                  "rootfi_created_at": "2023-11-07T05:31:56Z",
                  "rootfi_updated_at": "2023-11-07T05:31:56Z",
                  "platform_id": "<string>",
                  "nominal_code": "<string>",
                  "name": "<string>",
                  "description": "<string>",
                  "current_balance": 123,
                  "sub_category": "<string>",
                  "parent_account_id": "<string>",
                  "updated_at": "2023-11-07T05:31:56Z"
                }
              ],
              "variant": [
                {
                  "rootfi_id": 123,
                  "rootfi_created_at": "2023-11-07T05:31:56Z",
                  "rootfi_updated_at": "2023-11-07T05:31:56Z",
                  "platform_id": "<string>",
                  "parent_id": "<string>",
                  "name": "<string>",
                  "sku": "<string>",
                  "price": 123,
                  "compare_at_price": 123,
                  "attributes": "<unknown>"
                }
              ]
            }
          ],
          "addresses": [
            {
              "rootfi_id": 123,
              "rootfi_created_at": "2023-11-07T05:31:56Z",
              "rootfi_updated_at": "2023-11-07T05:31:56Z",
              "platform_id": "<string>",
              "parent_id": "<string>",
              "street": "<string>",
              "street2": "<string>",
              "locality": "<string>",
              "city": "<string>",
              "state": "<string>",
              "postal_code": "<string>",
              "country": "<string>"
            }
          ],
          "documents": [
            {
              "rootfi_id": 123,
              "rootfi_created_at": "2023-11-07T05:31:56Z",
              "rootfi_updated_at": "2023-11-07T05:31:56Z",
              "platform_id": "<string>",
              "file_name": "<string>",
              "file_type": "<string>",
              "file_size": 123,
              "document_type_id": "<string>",
              "document_uploaded": true,
              "updated_at": "2023-11-07T05:31:56Z"
            }
          ]
        }
      ],
      "contact": [
        {
          "rootfi_id": 123,
          "rootfi_created_at": "2023-11-07T05:31:56Z",
          "rootfi_updated_at": "2023-11-07T05:31:56Z",
          "platform_id": "<string>",
          "name": "<string>",
          "contact_name": "<string>",
          "email": "<string>",
          "phone": "<string>",
          "tax_number": "<string>",
          "registration_number": "<string>",
          "website": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z",
          "addresses": [
            {
              "rootfi_id": 123,
              "rootfi_created_at": "2023-11-07T05:31:56Z",
              "rootfi_updated_at": "2023-11-07T05:31:56Z",
              "platform_id": "<string>",
              "parent_id": "<string>",
              "street": "<string>",
              "street2": "<string>",
              "locality": "<string>",
              "city": "<string>",
              "state": "<string>",
              "postal_code": "<string>",
              "country": "<string>"
            }
          ],
          "phone_numbers": [
            {
              "rootfi_id": 123,
              "rootfi_created_at": "2023-11-07T05:31:56Z",
              "rootfi_updated_at": "2023-11-07T05:31:56Z",
              "platform_id": "<string>",
              "parent_id": "<string>",
              "number": "<string>"
            }
          ],
          "external_links": [
            {
              "rootfi_id": 123,
              "rootfi_created_at": "2023-11-07T05:31:56Z",
              "rootfi_updated_at": "2023-11-07T05:31:56Z",
              "platform_id": "<string>",
              "parent_id": "<string>",
              "link": "<string>"
            }
          ]
        }
      ],
      "currency": [
        {
          "rootfi_id": 123,
          "rootfi_created_at": "2023-11-07T05:31:56Z",
          "rootfi_updated_at": "2023-11-07T05:31:56Z",
          "platform_id": "<string>",
          "name": "<string>",
          "code": "<string>",
          "symbol": "<string>",
          "is_base_currency": true,
          "exchange_rate": 123,
          "updated_at": "2023-11-07T05:31:56Z"
        }
      ],
      "account": [
        {
          "rootfi_id": 123,
          "rootfi_created_at": "2023-11-07T05:31:56Z",
          "rootfi_updated_at": "2023-11-07T05:31:56Z",
          "platform_id": "<string>",
          "nominal_code": "<string>",
          "name": "<string>",
          "description": "<string>",
          "current_balance": 123,
          "sub_category": "<string>",
          "parent_account_id": "<string>",
          "updated_at": "2023-11-07T05:31:56Z"
        }
      ]
    }
  },
  "request_id": "<string>"
}

Authorizations

api_key
string
header
required

Your Commenda Integrations API key, sent in the api_key header.

Path Parameters

companyId
integer
required

Commenda company id.

Query Parameters

run_async
boolean

Process the write asynchronously. Required when data is an array (batch write).

Body

application/json
data
object
required

Response

201 - application/json

The created invoice_payments record (sync) or a sync id (async).

data
object
required
request_id
string
required