Vertex e-Invoicing Messaging API: Overview
Read about how to use the Vertex e-Invoicing Messaging API.
Warning
You must contact Vertex to enable this API before you can use it. Initially, this API is intended for use by new customers.
You can use this API to send Documents and process messages.
If you ingest files in a format other than VRBL, you must use this API.
URL
The API URL for the Vertex e-Invoicing Messaging API is https://{service_uri}/api/v1/messages, where {service_uri} is the service's URL.
The following table lists the available URL:
| URL | Description |
|---|---|
e-invoicing-message.vertexcloud.com/api/v1/messages | Production environment |
Components
The API consists of the following requests:
| Request (Endpoint) | Description |
|---|---|
List All Messages (/api/v1/messages) | Use this request to list all messages. |
Send a Message (/api/v1/messages) | Use this request to send a message to the system. |
Retrieve a Message (/api/v1/messages) | Use this request to retrieve a message. |
Confirm Processing of a Message (/api/v1/messages) | Use this request to process a message. |
Retrieve Message Documents (/api/v1/messages) | Use this request to retrieve the Documents that are associated with a message. |
The Vertex e-Invoicing Messaging API: Requests section contains the request topics. Fields are explained in the topics in the Vertex e-Invoicing Messaging API: Field References section.
Using the API
You can use this API to do the following:
Send messages
- Use the Send a Message request to send a Document to the service for processing.
Manage messages
You can use the following requests to retrieve information about messages and to help process them:
- Use the List All Messages request to list messages about previously submitted Documents.
- Use the Retrieve a Message request to retrieve a specified message.
- Use the Confirm Processing of a Message request to confirm a message.
- Use the Retrieve Message Documents request to retrieve the Documents that are associated with a specified message.
In this section
| Topic | Description |
|---|---|
| Vertex e-Invoicing Messaging API: Reference Guide | Read about how to use the Vertex Messaging API. |
| Vertex e-Invoicing Messaging API: Requests | The topics in this section explain the API requests. |
| List All Messages | Use this request to list all messages. |
| Send a Message | Use this request to send a message to the system. |
| Retrieve a Message | Use this request to retrieve a message. |
| Confirm Processing of a Message | Use this request to process a message. |
| Retrieve Message Documents | Use this request to retrieve the Documents that are associated with a message. |
| Vertex Messaging API: Field References | The topics in this section describe the fields used in the API. |
| Error Fields Reference | Read about the fields that return error information. |
| Message Details Fields Reference | Read about the fields that model message details. |
| Retrieve Message Fields Reference | Read about the messages fields that are returned when you retrieve a message. |
| Status Fields Reference | This topic lists the Status fields that are returned in requests. |
Updated about 19 hours ago
