Beta

Create Bulk Invoices (Sync)

POST

1 import datetime
2 
3 from mercoa import Mercoa
4 from mercoa.invoice_types import (
5     BulkInvoiceCreationRequest,
6     InvoiceCreationWithEntityRequest,
7     InvoiceLineItemCreationRequest,
8     PaymentDestinationOptions_Check,
9 )
10 
11 client = Mercoa(
12     token="YOUR_TOKEN",
13 )
14 client.invoice.bulk.create(
15     request=BulkInvoiceCreationRequest(
16         invoices=[
17             InvoiceCreationWithEntityRequest(
18                 status="NEW",
19                 amount=100.0,
20                 currency="USD",
21                 invoice_date=datetime.datetime.fromisoformat(
22                     "2021-01-01 00:00:00+00:00",
23                 ),
24                 due_date=datetime.datetime.fromisoformat(
25                     "2021-01-31 00:00:00+00:00",
26                 ),
27                 invoice_number="INV-123",
28                 note_to_self="For the month of January",
29                 payer_id="ent_8545a84e-a45f-41bf-bdf1-33b42a55812c",
30                 payment_source_id="pm_4794d597-70dc-4fec-b6ec-c5988e759769",
31                 vendor_id="ent_21661ac1-a2a8-4465-a6c0-64474ba8181d",
32                 payment_destination_id="pm_5fde2f4a-facc-48ef-8f0d-6b7d087c7b18",
33                 payment_destination_options=PaymentDestinationOptions_Check(
34                     delivery="MAIL",
35                     print_description=True,
36                 ),
37                 line_items=[
38                     InvoiceLineItemCreationRequest(
39                         amount=100.0,
40                         currency="USD",
41                         description="Product A",
42                         name="Product A",
43                         quantity=1.0,
44                         unit_price=100.0,
45                         category="EXPENSE",
46                         service_start_date=datetime.datetime.fromisoformat(
47                             "2021-01-01 00:00:00+00:00",
48                         ),
49                         service_end_date=datetime.datetime.fromisoformat(
50                             "2021-01-31 00:00:00+00:00",
51                         ),
52                         metadata={"key1": "value1", "key2": "value2"},
53                         gl_account_id="600394",
54                     )
55                 ],
56                 creator_entity_id="ent_8545a84e-a45f-41bf-bdf1-33b42a55812c",
57                 creator_user_id="user_e24fc81c-c5ee-47e8-af42-4fe29d895506",
58             )
59         ],
60     ),
61 )

Play

200FromObjects

1 {
2   "data": [
3     {
4       "id": "ent_21661ac1-a2a8-4465-a6c0-64474ba8181d",
5       "foreignId": "YOUR-INVOICE-ID"
6     },
7     {
8       "foreignId": "YOUR-SECOND-INVOICE-ID",
9       "error": "Invoice creation failed"
10     }
11   ]
12 }

Create multiple invoices in bulk. This endpoint will process synchronously and return a list of invoices that were created or failed to create.

Query parameters

emitWebhooksbooleanOptionalDefaults to false

If true, webhooks will be emitted for each invoice that is created. By default, webhooks are not emitted.

Request

This endpoint expects an object.

invoiceslist of objectsRequired

Response

This endpoint returns an object.

datalist of objects

Create Bulk Invoices (Sync)

Headers

Query parameters

Request

Response

Errors