# Edit invoice

### URI

&#x20;<mark style="color:orange;background-color:orange;">**PATCH**</mark>&#x20;

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

### Parameters

#### Header

<table data-header-hidden><thead><tr><th width="249"></th><th></th></tr></thead><tbody><tr><td><strong>Authorization</strong><br><code>string</code></td><td>set value to <code>Bearer SECRET_KEY</code></td></tr></tbody></table>

#### Body Param

<table data-header-hidden><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Invoice_id</strong><br><code>string</code> </td><td>Invoice id</td></tr><tr><td><strong>invoice_number</strong><br><code>string</code></td><td>Invoice number</td></tr><tr><td><strong>due_date</strong><br><code>string</code> </td><td>Invoice due dare</td></tr><tr><td><strong>items</strong><br><code>array</code> </td><td><p>The items array specifies the content in the invoice e.g:</p><pre class="language-json"><code class="lang-json">"items": [
        {
            "name": "Bananas",
            "quantity": "50",
            "unit_price": "100"
        },
        {
            "name": "Apple",
            "quantity": "20",
            "unit_price": "100"
        }
    ]
</code></pre></td></tr><tr><td><strong>shipping_fee</strong><br><code>string</code> </td><td>Shipping fee</td></tr><tr><td><strong>business_id</strong><br><code>string</code> </td><td>Bussiness id</td></tr><tr><td><strong>discount</strong><br><code>object</code></td><td><p>The discount contains the offered discount(s) for the invoice. e.g:</p><pre class="language-json"><code class="lang-json">"discount": {
        "type": "amount",
        "value": "500"
    }
</code></pre></td></tr><tr><td><strong>tax</strong><br><code>object</code></td><td><p>Tax object. e.g:</p><pre class="language-json"><code class="lang-json">"tax": {
        "type": "percentage",
        "value": 10,
        "description": "sample description"
    }
</code></pre></td></tr><tr><td><strong>note</strong><br><code>string</code></td><td>Invoice notes</td></tr><tr><td><strong>status</strong><br><code>string</code></td><td>Invoice status, this can either be <code>invoice</code> or <code>draft</code>  the default value <code>invoice</code>  </td></tr></tbody></table>

### Sample request

{% tabs %}
{% tab title="cURL" %}
{% code overflow="wrap" %}

```bash
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"
 }'
```

{% endcode %}
{% endtab %}

{% tab title="Node" %}
{% code overflow="wrap" lineNumbers="true" %}

```javascript
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);
});

```

{% endcode %}
{% endtab %}

{% tab title="PHP" %}
{% code overflow="wrap" lineNumbers="true" %}

```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;
```

{% endcode %}
{% endtab %}
{% endtabs %}

### Duplo Response

```json
{
    "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"
}
```
