Technical documentation
.dodocs Invoice MatchPoint API Integration
Overview
This guide provides a detailed step-by-step process to integrate DoDocs APIs for
matching purchase orders to invoices. This integration streamlines the invoicing
process by extracting, matching, and recording data from various sources like
emails, WhatsApp messages, and cloud storage into Excel or Google Sheets.
Prerequisites
1. API KEY: Obtain your API keys from DoDocs.
2. Environment Setup: Ensure you have access to your email, WhatsApp, cloud
storage, and spreadsheet services.
DoDocs.ai API Documentation
Description: API for document processing and management.
Version: 1.0
License: [API License](API license URL)
Base URL: https://apis.dodocs.ai/match-point/v1
Authentication:
- Header “Dodocs-API-Key: <Your API KEY>”
Endpoints
Upload document for processing
Endpoint: POST /upload
Description: Upload document for recognizing
Parameters:
- metadata (query, required) - Metadata information, specific external data< for example your sub-client uuid, address field for matching response.
metadata = {"mode": "sync"} - synclonous request, in that casr the response will comtain whole extracted data of uploaded document, it will take about 1-5 minutes.
metadata = {} - metadata = {} - send it if you use an async mode of processing and expecting extracted data via webhook and you don't have any special fields fo some specific integration condition, that you can agree with .dodcs team - file (multipart, form-data, required) - One or more files for processing.
Request Body:
- is empty
Response:
- 200 OK: Returns json
Example
{
"requestId": "1eba0925-8180-493d-87b7-551ab7b34a5d"
}
Retrieve data after processing
Recognised data passed to client using web hook call.
Webhook endpoint needs to be configured on Dodocs.ai by dodocs
administrators.
Send webhook URL to support@dodocs.ai email.
Webhook needs to receive POST request with json as request body.
Example of request body:
{
"requestId": "1eba0925-8180-493d-87b7-551ab7b34a5d",
“documentData”:
Technical documentation 2{
"items": [
{
"Rate": 3.75,
"taxRate": null,
"quantity": 21.5,
"taxAmount": 4.03,
"AmountInclTax": 84.66,
"itemDescription": "Item 1"
},
{
"Rate": 6.25,
"taxRate": null,
"quantity": 15,
"taxAmount": 4.69,
"AmountInclTax": 98.44,
"itemDescription": "Item 2"
},
{
"Rate": 4.00,
"taxRate": null,
"quantity": 11.4,
"taxAmount": 2.28,
"AmountInclTax": 47.88,
"itemDescription": "Item 3"
},
{
"Rate": 3.20,
"taxRate": null,
"quantity": 14.7,
"taxAmount": 2.35,
"AmountInclTax": 49.39,
"itemDescription": "Item 4"
}
],
"totalTax": 13.35,
Technical documentation 3"vendorName": "Vendor A"
,
"invoiceDate": "2025-01-16",
"totalAmount": 267.02,
"vendorTaxId": "XXXXXXXXXXXXXXX",
"customerName": "Customer A"
,
"customerTaxId": "XXXXXXXXXXXXXXX",
"invoiceNumber": "INVXXXXX",
"vendorAddress": "Address A"
,
"customerAddress": "Address B",
"totalAmountWithTax": 280.37
}
}
Notes
Ensure the API KEY is included in the request headers.
This API documentation provides an overview of available endpoints, their
usage, and expected responses. For further details, contact the API provider
at support@dodocs.ai.
Copyright © 2024 DoDocs