Invoice Collection Event - Email Received

Payload
1 {
2   "eventType": "invoice.collection.email.received",
3   "invoice": {
4     "approvalPolicy": [
5       {
6         "id": "apvl_8545a84e-a45f-41bf-bdf1-33b42a55812c",
7         "trigger": [
8           {
9             "type": "amount",
10             "amount": 100,
11             "currency": "USD"
12           }
13         ],
14         "rule": {
15           "type": "approver",
16           "identifierList": {
17             "type": "rolesList",
18             "value": [
19               "Admin",
20               "Controller"
21             ]
22           },
23           "numApprovers": 2
24         },
25         "upstreamPolicyId": "root",
26         "createdAt": "2024-01-01T00:00:00Z",
27         "updatedAt": "2024-01-02T00:00:00Z"
28       }
29     ],
30     "approvers": [
31       {
32         "approvalPolicyId": "apvl_5ce50275-1789-42ea-bc60-bb7e6d03635c",
33         "approvalSlotId": "inap_9bb311c9-7c15-4c9e-8148-63814e0abec6",
34         "action": "APPROVE",
35         "eligibleRoles": [
36           "admin"
37         ],
38         "eligibleUserIds": [
39           "user_e24fc81c-c5ee-47e8-af42-4fe29d895506"
40         ],
41         "date": "2021-01-01T00:00:00Z",
42         "assignedUserId": "user_e24fc81c-c5ee-47e8-af42-4fe29d895506"
43       }
44     ],
45     "createdAt": "2021-01-01T00:00:00Z",
46     "hasDocuments": true,
47     "hasSourceEmail": true,
48     "id": "in_26e7b5d3-a739-4b23-9ad9-6aaa085f47a9",
49     "metadata": {
50       "key1": "value1",
51       "key2": "value2"
52     },
53     "paymentDestinationConfirmed": true,
54     "status": "PAID",
55     "updatedAt": "2021-01-01T00:00:00Z",
56     "amount": 100,
57     "comments": [
58       {
59         "id": "ic_b3525b66-da94-4525-9f31-426bcf657128",
60         "text": "This is an approval comment",
61         "createdAt": "2021-01-01T00:00:00Z",
62         "updatedAt": "2021-01-01T00:00:00Z",
63         "user": {
64           "id": "user_ec3aafc8-ea86-408a-a6c1-545497badbbb",
65           "roles": [
66             "admin",
67             "approver"
68           ],
69           "createdAt": "2024-01-01T00:00:00Z",
70           "updatedAt": "2024-01-01T00:00:00Z",
71           "foreignId": "MY-DB-ID-12345",
72           "email": "john.doe@acme.com",
73           "name": "John Doe"
74         },
75         "associatedApprovalAction": {
76           "userId": "user_e24fc81c-c5ee-47e8-af42-4fe29d895506",
77           "action": "APPROVE"
78         }
79       }
80     ],
81     "creatorUser": {
82       "id": "user_ec3aafc8-ea86-408a-a6c1-545497badbbb",
83       "roles": [
84         "admin",
85         "approver"
86       ],
87       "createdAt": "2024-01-01T00:00:00Z",
88       "updatedAt": "2024-01-01T00:00:00Z",
89       "foreignId": "MY-DB-ID-12345",
90       "email": "john.doe@acme.com",
91       "name": "John Doe"
92     },
93     "currency": "USD",
94     "deductionDate": "2021-01-01T00:00:00Z",
95     "dueDate": "2021-01-31T00:00:00Z",
96     "foreignId": "YOUR-DATABASE-ID",
97     "invoiceDate": "2021-01-01T00:00:00Z",
98     "invoiceNumber": "INV-123",
99     "lineItems": [
100       {
101         "id": "inli_26672f38-eb9a-48f1-a7a0-f1b855e38cd7",
102         "currency": "USD",
103         "category": "EXPENSE",
104         "createdAt": "2021-01-01T00:00:00Z",
105         "updatedAt": "2021-01-01T00:00:00Z",
106         "amount": 100,
107         "description": "Product A",
108         "name": "Product A",
109         "quantity": 1,
110         "unitPrice": 100,
111         "serviceStartDate": "2021-01-01T00:00:00Z",
112         "serviceEndDate": "2021-01-31T00:00:00Z",
113         "metadata": {
114           "key1": "value1",
115           "key2": "value2"
116         },
117         "glAccountId": "600394"
118       }
119     ],
120     "noteToSelf": "For the month of January",
121     "payer": {
122       "acceptedTos": true,
123       "accountType": "business",
124       "createdAt": "2024-01-01T00:00:00Z",
125       "email": "customer@acme.com",
126       "id": "ent_8545a84e-a45f-41bf-bdf1-33b42a55812c",
127       "isCustomer": true,
128       "isNetworkPayee": false,
129       "isNetworkPayor": false,
130       "isPayee": false,
131       "isPayor": true,
132       "name": "Acme Inc.",
133       "profile": {
134         "business": {
135           "legalBusinessName": "Acme Inc.",
136           "taxIDProvided": true,
137           "email": "customer@acme.com",
138           "businessType": "llc",
139           "phone": {
140             "countryCode": "1",
141             "number": "4155551234"
142           },
143           "address": {
144             "addressLine1": "123 Main St",
145             "city": "San Francisco",
146             "stateOrProvince": "CA",
147             "postalCode": "94105",
148             "addressLine2": "Unit 1",
149             "country": "US"
150           },
151           "ownersProvided": true,
152           "taxId": {
153             "ein": {
154               "number": "12-3456789"
155             }
156           }
157         }
158       },
159       "status": "verified",
160       "updatedAt": "2024-01-02T00:00:00Z",
161       "accounts": [
162         {
163           "accountId": "85866843",
164           "postalCode": "94105",
165           "nameOnAccount": "John Doe"
166         }
167       ],
168       "counterpartyType": [
169         "ENTITY"
170       ],
171       "foreignId": "MY-DB-ID-12345",
172       "paymentMethods": [
173         {
174           "type": "bankAccount",
175           "accountName": "My Checking Account",
176           "accountNumber": "99988767623",
177           "accountType": "CHECKING",
178           "bankName": "Chase",
179           "createdAt": "2021-01-01T00:00:00Z",
180           "frozen": false,
181           "id": "pm_4794d597-70dc-4fec-b6ec-c5988e759769",
182           "isDefaultDestination": true,
183           "isDefaultSource": true,
184           "metadata": {},
185           "routingNumber": "12345678",
186           "status": "VERIFIED",
187           "supportedCurrencies": [
188             "USD"
189           ],
190           "updatedAt": "2021-01-01T00:00:00Z",
191           "confirmedByEntity": true
192         }
193       ]
194     },
195     "payerId": "ent_8545a84e-a45f-41bf-bdf1-33b42a55812c",
196     "paymentDestination": {
197       "type": "check",
198       "addressLine1": "123 Main St",
199       "city": "New York",
200       "country": "US",
201       "createdAt": "2021-01-01T00:00:00Z",
202       "frozen": false,
203       "id": "pm_5fde2f4a-facc-48ef-8f0d-6b7d087c7b18",
204       "isDefaultDestination": true,
205       "isDefaultSource": false,
206       "metadata": {},
207       "payToTheOrderOf": "John Doe",
208       "postalCode": "10001",
209       "stateOrProvince": "NY",
210       "supportedCurrencies": [
211         "USD"
212       ],
213       "updatedAt": "2021-01-01T00:00:00Z",
214       "addressLine2": "Apt 1",
215       "confirmedByEntity": true
216     },
217     "paymentDestinationId": "pm_5fde2f4a-facc-48ef-8f0d-6b7d087c7b18",
218     "paymentDestinationOptions": {
219       "type": "check",
220       "delivery": "MAIL",
221       "printDescription": true
222     },
223     "paymentSource": {
224       "type": "bankAccount",
225       "accountName": "My Checking Account",
226       "accountNumber": "99988767623",
227       "accountType": "CHECKING",
228       "bankName": "Chase",
229       "createdAt": "2021-01-01T00:00:00Z",
230       "frozen": false,
231       "id": "pm_4794d597-70dc-4fec-b6ec-c5988e759769",
232       "isDefaultDestination": true,
233       "isDefaultSource": true,
234       "metadata": {},
235       "routingNumber": "12345678",
236       "status": "VERIFIED",
237       "supportedCurrencies": [
238         "USD"
239       ],
240       "updatedAt": "2021-01-01T00:00:00Z",
241       "confirmedByEntity": true
242     },
243     "paymentSourceId": "pm_4794d597-70dc-4fec-b6ec-c5988e759769",
244     "processedAt": "2021-01-01T00:00:00Z",
245     "serviceEndDate": "2021-01-31T00:00:00Z",
246     "serviceStartDate": "2021-01-01T00:00:00Z",
247     "settlementDate": "2021-01-03T00:00:00Z",
248     "transactions": [
249       {
250         "type": "bankAccountToBankAccount",
251         "amount": 10000,
252         "createdAt": "2024-01-01T00:00:00Z",
253         "currency": "USD",
254         "id": "trx_bb08e72f-19f8-45f3-bcf9-46fdc46cb2f4",
255         "payer": {
256           "acceptedTos": true,
257           "accountType": "business",
258           "createdAt": "2024-01-01T00:00:00Z",
259           "email": "customer@acme.com",
260           "id": "ent_8545a84e-a45f-41bf-bdf1-33b42a55812c",
261           "isCustomer": true,
262           "isNetworkPayee": false,
263           "isNetworkPayor": false,
264           "isPayee": false,
265           "isPayor": true,
266           "name": "Acme Inc.",
267           "profile": {
268             "business": {
269               "legalBusinessName": "Acme Inc.",
270               "taxIDProvided": true,
271               "email": "customer@acme.com",
272               "businessType": "llc",
273               "phone": {
274                 "countryCode": "1",
275                 "number": "4155551234"
276               },
277               "address": {
278                 "addressLine1": "123 Main St",
279                 "city": "San Francisco",
280                 "stateOrProvince": "CA",
281                 "postalCode": "94105",
282                 "addressLine2": "Unit 1",
283                 "country": "US"
284               },
285               "ownersProvided": true,
286               "taxId": {
287                 "ein": {
288                   "number": "12-3456789"
289                 }
290               }
291             }
292           },
293           "status": "verified",
294           "updatedAt": "2024-01-02T00:00:00Z",
295           "accounts": [
296             {
297               "accountId": "85866843",
298               "postalCode": "94105",
299               "nameOnAccount": "John Doe"
300             }
301           ],
302           "counterpartyType": [
303             "ENTITY"
304           ],
305           "foreignId": "MY-DB-ID-12345",
306           "paymentMethods": [
307             {
308               "type": "bankAccount",
309               "accountName": "My Checking Account",
310               "accountNumber": "99988767623",
311               "accountType": "CHECKING",
312               "bankName": "Chase",
313               "createdAt": "2021-01-01T00:00:00Z",
314               "frozen": false,
315               "id": "pm_4794d597-70dc-4fec-b6ec-c5988e759769",
316               "isDefaultDestination": true,
317               "isDefaultSource": true,
318               "metadata": {},
319               "routingNumber": "12345678",
320               "status": "VERIFIED",
321               "supportedCurrencies": [
322                 "USD"
323               ],
324               "updatedAt": "2021-01-01T00:00:00Z",
325               "confirmedByEntity": true
326             }
327           ]
328         },
329         "payerId": "ent_bb08e72f-19f8-45f3-bcf9-46fdc46cb2f4",
330         "paymentDestination": {
331           "type": "bankAccount",
332           "accountName": "My Checking Account",
333           "accountNumber": "99988767623",
334           "accountType": "CHECKING",
335           "bankName": "Chase",
336           "createdAt": "2021-01-01T00:00:00Z",
337           "frozen": false,
338           "id": "pm_4794d597-70dc-4fec-b6ec-c5988e759769",
339           "isDefaultDestination": true,
340           "isDefaultSource": true,
341           "metadata": {},
342           "routingNumber": "12345678",
343           "status": "VERIFIED",
344           "supportedCurrencies": [
345             "USD"
346           ],
347           "updatedAt": "2021-01-01T00:00:00Z",
348           "confirmedByEntity": true
349         },
350         "paymentDestinationId": "pm_65523ab0-043d-4706-b2b2-0b73fed92269",
351         "paymentSource": {
352           "type": "bankAccount",
353           "accountName": "My Checking Account",
354           "accountNumber": "99988767623",
355           "accountType": "CHECKING",
356           "bankName": "Chase",
357           "createdAt": "2021-01-01T00:00:00Z",
358           "frozen": false,
359           "id": "pm_4794d597-70dc-4fec-b6ec-c5988e759769",
360           "isDefaultDestination": true,
361           "isDefaultSource": true,
362           "metadata": {},
363           "routingNumber": "12345678",
364           "status": "VERIFIED",
365           "supportedCurrencies": [
366             "USD"
367           ],
368           "updatedAt": "2021-01-01T00:00:00Z",
369           "confirmedByEntity": true
370         },
371         "paymentSourceId": "pm_65523ab0-043d-4706-b2b2-0b73fed92269",
372         "status": "COMPLETED",
373         "updatedAt": "2024-01-01T00:00:00Z",
374         "vendor": {
375           "acceptedTos": false,
376           "accountType": "business",
377           "createdAt": "2024-01-01T00:00:00Z",
378           "email": "vendor@bigboxstore.com",
379           "id": "ent_21661ac1-a2a8-4465-a6c0-64474ba8181d",
380           "isCustomer": false,
381           "isNetworkPayee": false,
382           "isNetworkPayor": false,
383           "isPayee": true,
384           "isPayor": false,
385           "name": "Big Box Store",
386           "profile": {
387             "business": {
388               "legalBusinessName": "Big Box Store",
389               "taxIDProvided": false,
390               "email": "vendor@bigboxstore.com",
391               "businessType": "publicCorporation",
392               "ownersProvided": false
393             }
394           },
395           "status": "unverified",
396           "updatedAt": "2024-01-02T00:00:00Z",
397           "counterpartyType": [
398             "ENTITY"
399           ],
400           "foreignId": "MY-DB-ID-90909",
401           "paymentMethods": [
402             {
403               "type": "bankAccount",
404               "accountName": "Vendor Checking Account",
405               "accountNumber": "55934059697648",
406               "accountType": "CHECKING",
407               "bankName": "Chase",
408               "createdAt": "2021-01-01T00:00:00Z",
409               "frozen": false,
410               "id": "pm_7610541f-4619-4033-8620-cfccfb811293",
411               "isDefaultDestination": true,
412               "isDefaultSource": true,
413               "metadata": {},
414               "routingNumber": "66554433",
415               "status": "NEW",
416               "supportedCurrencies": [
417                 "USD"
418               ],
419               "updatedAt": "2021-01-01T00:00:00Z",
420               "confirmedByEntity": false
421             }
422           ]
423         },
424         "vendorId": "ent_bb08e72f-19f8-45f3-bcf9-46fdc46cb2f4"
425       }
426     ],
427     "vendor": {
428       "acceptedTos": false,
429       "accountType": "business",
430       "createdAt": "2024-01-01T00:00:00Z",
431       "email": "vendor@bigboxstore.com",
432       "id": "ent_21661ac1-a2a8-4465-a6c0-64474ba8181d",
433       "isCustomer": false,
434       "isNetworkPayee": false,
435       "isNetworkPayor": false,
436       "isPayee": true,
437       "isPayor": false,
438       "name": "Big Box Store",
439       "profile": {
440         "business": {
441           "legalBusinessName": "Big Box Store",
442           "taxIDProvided": false,
443           "email": "vendor@bigboxstore.com",
444           "businessType": "publicCorporation",
445           "ownersProvided": false
446         }
447       },
448       "status": "unverified",
449       "updatedAt": "2024-01-02T00:00:00Z",
450       "counterpartyType": [
451         "ENTITY"
452       ],
453       "foreignId": "MY-DB-ID-90909",
454       "paymentMethods": [
455         {
456           "type": "bankAccount",
457           "accountName": "Vendor Checking Account",
458           "accountNumber": "55934059697648",
459           "accountType": "CHECKING",
460           "bankName": "Chase",
461           "createdAt": "2021-01-01T00:00:00Z",
462           "frozen": false,
463           "id": "pm_7610541f-4619-4033-8620-cfccfb811293",
464           "isDefaultDestination": true,
465           "isDefaultSource": true,
466           "metadata": {},
467           "routingNumber": "66554433",
468           "status": "NEW",
469           "supportedCurrencies": [
470             "USD"
471           ],
472           "updatedAt": "2021-01-01T00:00:00Z",
473           "confirmedByEntity": false
474         }
475       ]
476     },
477     "vendorId": "ent_21661ac1-a2a8-4465-a6c0-64474ba8181d"
478   },
479   "email": {
480     "subject": "Re: Invoice Past Due - Please Review",
481     "body": "This slipped under my radar; I will make sure to pay this today."
482   }
483 }
An email was received from a payee to collect an overdue invoice (in development)
Payload

The payload of this webhook request is an object.
eventTypestringRequired
The type of the event.
invoiceobjectRequired
The invoice involved in the event.
emailobjectOptional
Email message related to the invoice collection.
Response

200
any
Return a 200 status to indicate that the data was received successfully.