Edit invoice

Edit an invoice details

URI

PATCH

https://api.tryduplo.com/v1/merchants/invoice

Parameters

Header

Authorization string	set value to Bearer SECRET_KEY

Body Param

Invoice_id string	Invoice id
invoice_number string	Invoice number
due_date string	Invoice due dare
items array	The items array specifies the content in the invoice e.g: "items": [ { "name": "Bananas", "quantity": "50", "unit_price": "100" }, { "name": "Apple", "quantity": "20", "unit_price": "100" } ]
shipping_fee string	Shipping fee
business_id string	Bussiness id
discount object	The discount contains the offered discount(s) for the invoice. e.g: "discount": { "type": "amount", "value": "500" }
tax object	Tax object. e.g: "tax": { "type": "percentage", "value": 10, "description": "sample description" }
note string	Invoice notes
status string	Invoice status, this can either be invoice or draft the default value invoice

Sample request

cURL

curl --location --request PATCH 'https://api.tryduplo.com/v1/merchants/invoice' \
--header 'Authorization: Bearer dp_live_856879df3e6ecdb14a918e24bba6d480e0564a4eabfdba938fc23b82905e54bac25a71dbcdef66c97b8c72ca7e16cf03a576857261f2f16f5335ca5024620b14268823a7d78922cfdd97cefc61050139fd92a7a0c5840e016050552ccadbbec642d2ff8d35a09225c7ec4fd1e347b' \
--header 'Content-Type: application/json' \
--data-raw '{
"business_id": "45ef61-dd52-4f51-bccb-8e594a711760",
"invoice_id": "396c51-658d-4225-b367-7e121c88e87a",
 "invoice_number": "0000000012", 
 "due_date": "2022-06-011",
 "items": [
    {
    "name": "Rice",
    "quantity": "10",
    "unit_price": "500"
    },
    {
    "name": "Tomato",
    "quantity": "10",
    "unit_price": "100"
    }
 ],
    "shipping_fee": "100",
    "discount": {
    "type": "percentage", 
    "value": "10" 
    },
    "tax": {
    "description" : "Sample description", 
    "type": "amount", 
    "value": "10"
    },
 "note": "A sample detailed note to ensure that the customer can make payment", 
 "status": "invoice"
 }'

Node

var axios = require('axios');
var data = ''{
    "business_id": "45f61-dd52-4f51-bccb-8ea11760", 
    "invoice_id": "396c513a-658d-4225-b367-7e121c88e87a",
    "invoice_number": "00000000012"
    "due_date": "2022-06-12",
    "items": [
        {
            "name": "Banana",
            "quantity": "50",
            "unit_price": "100"
        },
        {
            "name": "Apple",
            "quantity": "20",
            "unit_price": "100"
        }
    ],
    "shipping_fee": "100",
    "discount": {
        "type": "amount",
        "value": "500"
    },
    "tax": {
        "type": "percentage",
        "value": 10,
        "description": "sample description t"
    },
    "note": "sample note for creating this invoice for another test",
    "status": "invoice"
}';

var config = {
  method: 'patch',
  url: 'https://app-api.tryduplo.com/v1/merchants/invoice',
  headers: { },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.tryduplo.com/v1/merchants/invoice',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'PATCH',
  CURLOPT_POSTFIELDS =>'{
"business_id": "4e9f61-dd52-4f51-bccb-8e5711760",
"invoice_id": "396c513a-658d-4225-b367-7e121c88e87a",
 "invoice_number": "00000000012", 
 "due_date": "2022-06-011",
 "items": [
    {
    "name": "Rice",
    "quantity": "10",
    "unit_price": "500"
    },
    {
    "name": "Tomato",
    "quantity": "10",
    "unit_price": "100"
    }
 ],
    "shipping_fee": "100",
    "discount": {
    "type": "percentage", 
    "value": "10" 
    },
    "tax": {
    "description" : "Sample description", 
    "type": "amount", 
    "value": "10"
    },
 "note": "A sample detailed note to ensure that the customer can make payment", 
 "status": "invoice"
 }',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer dp_live_856879df3e6ecdb14a918e24bba6d480e0564a4eabfdba938fc23b820ac905e54bac25a71dbcdef66c97b8c72ca7e16cf03857261f2f16f5335ca5024620b14268823a7d78922cfdd97cefc61050139fd92a7a0c5840e016050552ccadbbec642d2ff8d35a09225c7ec4fd1e347b',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Duplo Response

{
    "data": {
        "id": "c1f9df9b-8dd3-4b43-aee9-ecc5525d27a2",
        "invoice_number": "78689936947",
        "title": "Invoice for Mwenda Deno",
        "recipient": "wal_ZKmo7StVZMrZ",
        "due_date": "2022-05-25T00:00:00.000Z",
        "items": [
            {
                "name": "sample name",
                "total": 7510.5,
                "quantity": 15,
                "unit_price": 500.7
            },
            {
                "name": "sample name 2",
                "total": 3118.6,
                "quantity": 31,
                "unit_price": 100.6
            }
        ],
        "shipping_fee": 670.9,
        "discount": {
            "type": "amount",
            "value": 400.5
        },
        "tax": {
            "type": "percentage",
            "value": 10.2,
            "description": "sample description"
        },
        "note": "sample note",
        "status": "draft",
        "public_id": "oXFpXwUQIwoF8zOabzKLjEHv4kZTydNb",
        "account": {
            "provider": {
                "id": "wema",
                "default": true,
                "prefixes": [
                    "222",
                    "919",
                    "888"
                ],
                "bank_code": "111",
                "bank_name": "Wema Bank",
                "is_prefix": true,
                "credentials": {}
            },
            "account_ref": "act_MR1sJ8bh2YlK",
            "account_number": "8880000363"
        },
        "payment": null,
        "created_at": "2022-05-25T15:19:05.650Z",
        "update_at": "2022-05-25T15:19:05.651Z",
        "business_id": "80efed51-96fc-43c7-9075-9f78877d26bc"
    },
    "errors": {},
    "message": "Request successful"
}