Actions26
Overview
This node integrates with the Dental Office Cloud API to create a new patient record ("Paciente"). It allows users to register patients in a specific clinic by providing essential personal and clinical information. This operation is useful for dental clinics or offices that want to automate patient management workflows, such as adding new patients from form submissions or other systems directly into their Dental Office Cloud database.
Practical examples include:
- Automatically creating patient profiles when a new patient fills out an online registration form.
- Syncing patient data from external CRM or healthcare management systems into the Dental Office Cloud.
- Batch importing patient data via n8n workflows.
Properties
| Name | Meaning |
|---|---|
| Nome | Full name of the patient (required). |
| ID da Clínica | Numeric ID of the clinic where the patient will be registered (required). |
| Data de Nascimento | Patient's birth date and time (optional). |
| Gênero | Gender of the patient; options are "Masculino" (0) or "Feminino" (1) (optional). |
| Situação do Paciente | Current situation/status of the patient; options: 1ª Consulta (1), Em Tratamento (2), Tratamento Concluído (3), Alta (4), Abandono (7) (optional). |
| Especialidade | Specialty of the patient's treatment; options: Cirurgia (2), Endodontia (4), Ortodontia (5), Periodontia (6), Prótese (7), Implantodontia (8) (optional). |
| Endereços | JSON string representing address attributes of the patient (optional). |
| Contatos | JSON string representing contact attributes of the patient (optional). |
| Documentos | JSON string representing document attributes of the patient (optional). |
Output
The node outputs the JSON response returned by the Dental Office Cloud API after creating the patient. This typically includes the newly created patient's details such as their unique ID, name, clinic association, and any other stored attributes.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Dental Office Cloud API.
- The node needs an API authentication token or API key credential configured in n8n to authorize requests.
- Proper permissions on the API to create patient records.
- Input JSON fields (addressesAttributes, contactsAttributes, documentsAttributes) must be valid JSON strings; otherwise, the node throws an error.
Troubleshooting
- Invalid JSON format errors: If the JSON input properties (addressesAttributes, contactsAttributes, documentsAttributes) are malformed, the node will throw an error indicating invalid JSON format. To fix, ensure these inputs are correctly formatted JSON strings.
- Missing required fields: The "Nome" and "ID da Clínica" fields are mandatory. Omitting them will likely cause the API request to fail.
- API authentication errors: Ensure the API credentials are correctly set up in n8n and have sufficient permissions.
- Unexpected API errors: Check the API response message for details. Network issues or incorrect parameter values can cause failures.
Links and References
- Dental Office Cloud API documentation (not provided here, but recommended to consult for detailed API specs)
- n8n documentation on creating custom nodes and handling JSON inputs