Actions20
Overview
This node integrates with the Consultorio Live API to manage clinic and medical office operations. Specifically, the "Fatura" (Invoice) resource with the "Criar" (Create) operation allows users to create new invoices within the system. This is useful for automating billing processes by programmatically generating invoices linked to patients, appointments, and procedures.
Practical examples include:
- Automatically creating an invoice after a patient’s appointment is completed.
- Generating invoices for multiple procedures performed during a visit.
- Integrating billing workflows into broader clinic management automation.
Properties
| Name | Meaning |
|---|---|
| Dados Da Fatura | Collection of invoice data including due date, description, related appointment ID, patient ID, items, and total amount. |
| - Data De Vencimento | Due date of the invoice (date and time). |
| - Descrição | Description of the invoice. |
| - ID Do Agendamento | ID of the related appointment (optional). |
| - ID Do Paciente | ID of the patient associated with the invoice (required). |
| - Itens | List of invoice items, each containing: |
| -- ID Do Procedimento | Procedure ID for the item (required). |
| -- Quantidade | Quantity of the procedure/item (default 1). |
| -- Preço Unitário | Unit price of the procedure/item (default 0). |
| - Valor | Total amount of the invoice (required). |
Output
The node outputs JSON data representing the created invoice as returned by the Consultorio Live API. This typically includes details such as the invoice ID, status, amounts, linked patient and appointment IDs, and itemized billing information.
If the API supports binary data (e.g., PDF invoice files), it would be included in the binary output field; however, this is not indicated in the provided code or properties.
Dependencies
- Requires an API key credential for authenticating with the Consultorio Live API.
- The base URL for the API must be configured in the node credentials.
- The node depends on the external Consultorio Live service being available and accessible.
Troubleshooting
- Missing required fields: Errors may occur if mandatory fields like patient ID, procedure ID, or total amount are missing. Ensure all required inputs are provided.
- Invalid IDs: Using non-existent patient, appointment, or procedure IDs will likely cause API errors. Verify IDs before submission.
- API connectivity issues: Network problems or incorrect API credentials can lead to authentication failures or timeouts.
- Data format errors: Incorrectly formatted dates or numbers might cause validation errors from the API.
To resolve these:
- Double-check input values and required fields.
- Confirm API credentials and endpoint configuration.
- Review error messages returned by the API for specific guidance.
Links and References
- Consultorio Live API Documentation (example link, replace with actual)
- n8n Documentation on Creating Custom Nodes
- General info on Medical Billing Automation