Billing API

Examples - POST invoice

OVERVIEW

Use the POST method to post a new LEDES invoice. The following fields are mandatory when using the POST invoice:

  • firmId, firmOfficeId - no source, find from Legal Tracker Application/support
  • matterId - Obtain from GET Matter Endpoint
  • Company-ID (header) – Obtain from Company List API
  • typeId – Obtain from GET endpoint 

Posting New LEDES Invoice with attachment


If you have an attachment to post with your invoice, please upload it first, as you will need the fileKey prior to posting the invoice. 
Upload a new document with an attachment specified by fileKey:

  1. Use the eFiles API to obtain an upload link.
  2. Upload a file to temporary storage. Please refer to the eFiles API for more details and examples.
  3. Create the new document.

POST example:

https://api.thomsonreuters.com/legal-tracker/billing-api/v1/invoices

{
    "firmId": 52579,
    "firmOfficeId": 52580,
    "matterId": "25219",
    "currency": "USD",
    "isLedes": true,
   "content": "LEDES98BI V2[]\nINVOICE_DATE|INVOICE_NUMBER|CLIENT_ID|LAW_FIRM_MATTER_ID|INVOICE_TOTAL|BILLING_START_DATE|BILLING_END_DATE|INVOICE_DESCRIPTION|LINE_ITEM_NUMBER|EXP/FEE/INV_ADJ_TYPE|LINE_ITEM_NUMBER_OF_UNITS|LINE_ITEM_ADJUSTMENT_AMOUNT|LINE_ITEM_TOTAL|LINE_ITEM_DATE|LINE_ITEM_TASK_CODE|LINE_ITEM_EXPENSE_CODE|LINE_ITEM_ACTIVITY_CODE|TIMEKEEPER_ID|LINE_ITEM_DESCRIPTION|LAW_FIRM_ID|LINE_ITEM_UNIT_COST|TIMEKEEPER_NAME|TIMEKEEPER_CLASSIFICATION|CLIENT_MATTER_ID|PO_NUMBER|CLIENT_TAX_ID|MATTER_NAME|INVOICE_TAX_TOTAL|INVOICE_NET_TOTAL|INVOICE_CURRENCY|TIMEKEEPER_LAST_NAME|TIMEKEEPER_FIRST_NAME|ACCOUNT_TYPE|LAW_FIRM_NAME|LAW_FIRM_ADDRESS_1|LAW_FIRM_ADDRESS_2|LAW_FIRM_CITY|LAW_FIRM_STATEorREGION|LAW_FIRM_POSTCODE|LAW_FIRM_COUNTRY|CLIENT_NAME|CLIENT_ADDRESS_1|CLIENT_ADDRESS_2|CLIENT_CITY|CLIENT_STATEorREGION|CLIENT_POSTCODE|CLIENT_COUNTRY|LINE_ITEM_TAX_RATE|LINE_ITEM_TAX_TOTAL|LINE_ITEM_TAX_TYPE|INVOICE_REPORTED_TAX_TOTAL|INVOICE_TAX_CURRENCY[]
20200324|_98BI FE_ILLA|1|1|1404.7796|20200201|20200229||1|F|3.5000|120.3214|999.7815|20200201|B140||A109|RATESHTK1|fee 1|44316|220.3333|RATESHTK1_First RATESHTK1_Last|AS|68290||Federal Tax ID|_qa_aut_matter_10|216.2946|1188.4850|USD|RATESHTK1_Last|RATESHTK1_First|O|Firm qa|abcdefghijklmnopqrstuvwxyz abcdefghijklmnop|abcdefghijklmnopqrstuvwxyz abcdefghijklmnopqrstuvwxyz abcdef|abcdefghijklmnopqrstuvwxyz abcdefghijklm|Alabama|00501|USA|||||||USA|.121475|108.2935|VAT||[]
20200324|_98BI FE_ILLA|1|1|1404.7796|20200201|20200229||1|E|11.0000|-11.2124|140.0429|20200201||E104||RATESHTK1|expense 1|44316|12.3546|RATESHTK1_First RATESHTK1_Last|AS|68290||Federal Tax ID|_qa_aut_matter_10|216.2946|1188.4850|USD|RATESHTK1_Last|RATESHTK1_First|O|Firm qa|abcdefghijklmnopqrstuvwxyz abcdefghijklmnop|abcdefghijklmnopqrstuvwxyz abcdefghijklmnopqrstuvwxyz abcdef|abcdefghijklmnopqrstuvwxyz abcdefghijklm|Alabama|00501|USA|||||||USA|.123145|15.3547|VAT||[]
20200324|_98BI FE_ILLA|1|1|1404.7796|20200201|20200229||1|IF|0.0000|120.3214|191.6345|20200229||||||44316||||68290||Federal Tax ID|_qa_aut_matter_10|216.2946|1188.4850|USD|||O|Firm qa|abcdefghijklmnopqrstuvwxyz abcdefghijklmnop|abcdefghijklmnopqrstuvwxyz abcdefghijklmnopqrstuvwxyz abcdef|abcdefghijklmnopqrstuvwxyz abcdefghijklm|Alabama|00501|USA|||||||USA|.5926884162|71.3131|VAT||[]
20200324|_98BI FE_ILLA|1|1|1404.7796|20200201|20200229||1|IE|0.0000|51.9874|73.3207|20200229||||||44316||||68290||Federal Tax ID|_qa_aut_matter_10|216.2946|1188.4850|USD|||O|Firm qa|abcdefghijklmnopqrstuvwxyz abcdefghijklmnop|abcdefghijklmnopqrstuvwxyz abcdefghijklmnopqrstuvwxyz abcdef|abcdefghijklmnopqrstuvwxyz abcdefghijklm|Alabama|00501|USA|||||||USA|.4103552015|21.3333|GST||[]",
    "PostedDateTime": "",
    "ApprovedDateTime": "",
    "attachments": [
        {
            "typeId": "2",
            "description": "hullo",
            "fileKey": "aa724776-6b3f-409c-8273-dfc515788463:TWljcm9zb2Z0VGVhbXMtaW1hZ2UucG5n"
        }
    ]
}

 

Posting New LEDES Invoice with multiple attachments


If you have an attachment to post with your invoice, please upload it first, as you will need the fileKey prior to posting the invoice. 
Upload a new document with an attachment specified by fileKey:

  1. Use the eFiles API to obtain an upload link.
  2. Upload a file to temporary storage. Please refer to the eFiles API for more details and examples.
  3. Create the new document.
  4. Repeat the steps to upload multiple attachments.
  5. You will need each file key when submitting the invoice to have them linked to the invoice.

POST example with multiple attachments:

https://api.thomsonreuters.com/legal-tracker/billing-api/v1/invoices

{
    "firmId": 52579,
    "firmOfficeId": 52580,
    "matterId": "25219",
    "currency": "USD",
    "isLedes": true,
   "content": "LEDES98BI V2[]\nINVOICE_DATE|INVOICE_NUMBER|CLIENT_ID|LAW_FIRM_MATTER_ID|INVOICE_TOTAL|BILLING_START_DATE|BILLING_END_DATE|INVOICE_DESCRIPTION|LINE_ITEM_NUMBER|EXP/FEE/INV_ADJ_TYPE|LINE_ITEM_NUMBER_OF_UNITS|LINE_ITEM_ADJUSTMENT_AMOUNT|LINE_ITEM_TOTAL|LINE_ITEM_DATE|LINE_ITEM_TASK_CODE|LINE_ITEM_EXPENSE_CODE|LINE_ITEM_ACTIVITY_CODE|TIMEKEEPER_ID|LINE_ITEM_DESCRIPTION|LAW_FIRM_ID|LINE_ITEM_UNIT_COST|TIMEKEEPER_NAME|TIMEKEEPER_CLASSIFICATION|CLIENT_MATTER_ID|PO_NUMBER|CLIENT_TAX_ID|MATTER_NAME|INVOICE_TAX_TOTAL|INVOICE_NET_TOTAL|INVOICE_CURRENCY|TIMEKEEPER_LAST_NAME|TIMEKEEPER_FIRST_NAME|ACCOUNT_TYPE|LAW_FIRM_NAME|LAW_FIRM_ADDRESS_1|LAW_FIRM_ADDRESS_2|LAW_FIRM_CITY|LAW_FIRM_STATEorREGION|LAW_FIRM_POSTCODE|LAW_FIRM_COUNTRY|CLIENT_NAME|CLIENT_ADDRESS_1|CLIENT_ADDRESS_2|CLIENT_CITY|CLIENT_STATEorREGION|CLIENT_POSTCODE|CLIENT_COUNTRY|LINE_ITEM_TAX_RATE|LINE_ITEM_TAX_TOTAL|LINE_ITEM_TAX_TYPE|INVOICE_REPORTED_TAX_TOTAL|INVOICE_TAX_CURRENCY[]
20200324|_98BI FE_ILLA|1|1|1404.7796|20200201|20200229||1|F|3.5000|120.3214|999.7815|20200201|B140||A109|RATESHTK1|fee 1|44316|220.3333|RATESHTK1_First RATESHTK1_Last|AS|68290||Federal Tax ID|_qa_aut_matter_10|216.2946|1188.4850|USD|RATESHTK1_Last|RATESHTK1_First|O|Firm qa|abcdefghijklmnopqrstuvwxyz abcdefghijklmnop|abcdefghijklmnopqrstuvwxyz abcdefghijklmnopqrstuvwxyz abcdef|abcdefghijklmnopqrstuvwxyz abcdefghijklm|Alabama|00501|USA|||||||USA|.121475|108.2935|VAT||[]
20200324|_98BI FE_ILLA|1|1|1404.7796|20200201|20200229||1|E|11.0000|-11.2124|140.0429|20200201||E104||RATESHTK1|expense 1|44316|12.3546|RATESHTK1_First RATESHTK1_Last|AS|68290||Federal Tax ID|_qa_aut_matter_10|216.2946|1188.4850|USD|RATESHTK1_Last|RATESHTK1_First|O|Firm qa|abcdefghijklmnopqrstuvwxyz abcdefghijklmnop|abcdefghijklmnopqrstuvwxyz abcdefghijklmnopqrstuvwxyz abcdef|abcdefghijklmnopqrstuvwxyz abcdefghijklm|Alabama|00501|USA|||||||USA|.123145|15.3547|VAT||[]
20200324|_98BI FE_ILLA|1|1|1404.7796|20200201|20200229||1|IF|0.0000|120.3214|191.6345|20200229||||||44316||||68290||Federal Tax ID|_qa_aut_matter_10|216.2946|1188.4850|USD|||O|Firm qa|abcdefghijklmnopqrstuvwxyz abcdefghijklmnop|abcdefghijklmnopqrstuvwxyz abcdefghijklmnopqrstuvwxyz abcdef|abcdefghijklmnopqrstuvwxyz abcdefghijklm|Alabama|00501|USA|||||||USA|.5926884162|71.3131|VAT||[]
20200324|_98BI FE_ILLA|1|1|1404.7796|20200201|20200229||1|IE|0.0000|51.9874|73.3207|20200229||||||44316||||68290||Federal Tax ID|_qa_aut_matter_10|216.2946|1188.4850|USD|||O|Firm qa|abcdefghijklmnopqrstuvwxyz abcdefghijklmnop|abcdefghijklmnopqrstuvwxyz abcdefghijklmnopqrstuvwxyz abcdef|abcdefghijklmnopqrstuvwxyz abcdefghijklm|Alabama|00501|USA|||||||USA|.4103552015|21.3333|GST||[]",
    "PostedDateTime": "",
    "ApprovedDateTime": "",
    "attachments": [
        {
            "typeId": "78032",
            "description": "hullo",
            "fileKey": "d0eba5fd-130e-4eaa-8f39-78bc41e068f8:TWljcm9zb2Z0VGVhbXMtaW1hZ2UgKDQpICgxKS5wbmc="
        },
          {
            "typeId": "78032",
            "description": "hullo",
            "fileKey": "c455f02b-a76d-41f3-b5a0-285c05749dee:MjAyMTExMjZfU0loemVJLnBkZg=="
        },
          {
            "typeId": "78032",
            "description": "hullo",
            "fileKey": "e0a09153-76ce-4c4c-831a-2d22081ac55c:Xzk4QmhoaCBFXzB0eCAoMSkucGRm"
        }
    ]
}

 

Last Updated: Nov 08,2024