n8n-nodes-fyo

This is an n8n community node for integrating with the FYO API. It provides access to grain trading operations, financial transactions, and ARCA (Argentine tax authority) documentation.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes (Recommended)

1. Go to Settings > Community Nodes in your n8n instance
2. Select Install
3. Enter n8n-nodes-fyo in the Enter npm package name field
4. Agree to the risks and select Install

Manual Installation

To install this node manually in a self-hosted n8n instance:

cd ~/.n8n/nodes
npm install n8n-nodes-fyo

Then restart n8n.

Credentials

To use this node, you need to configure the FYO API credentials:

| Field | Description | |-------|-------------| | Client ID | Your FYO API client identifier | | Username | Your FYO username or email | | Password | Your FYO account password | | Scope | OAuth2 scope to request (provided by FYO) | | Environment | Production, Demo, or Custom URL |

Setting up credentials

1. In n8n, go to Credentials > New
2. Search for FYO API
3. Fill in your credentials provided by FYO
4. Click Test to verify the connection
5. Click Save

Operations

Grains Resource

Operations for grain trading management.

Get Contracts

Retrieve grain contracts.

| Search By | Parameters | |-----------|------------| | Date Range | Date From (required), Date To (optional) | | Broker Contract Number | Broker Contract Number |

Get Settlements

Retrieve grain settlements.

| Search By | Parameters | |-----------|------------| | Date Range | Date From (required), Date To (optional) | | Broker Contract Number | Broker Contract Number | | Receipt Number | Receipt Number |

Get Invoices

Retrieve grain invoices.

| Search By | Parameters | |-----------|------------| | Date Range | Date From (required), Date To (optional) | | Broker Contract Number | Broker Contract Number | | Receipt Number | Receipt Number |

Get Applications

Retrieve grain applications.

| Search By | Parameters | |-----------|------------| | Date Range | Date From (required), Date To (optional) | | Broker Contract Number | Broker Contract Number | | CTG Number | CTG Number |

Get Fixings

Retrieve grain price fixings.

| Search By | Parameters | |-----------|------------| | Date Range | Date From (required), Date To (optional) | | Broker Contract Number | Broker Contract Number | | Fixing Number | Fixing Number |

Get Unloads

Retrieve grain unloads.

| Search By | Parameters | |-----------|------------| | Date Range | Date From (required), Date To (optional) | | CTG Number | CTG Number |

Get Withholdings

Retrieve tax withholdings.

| Search By | Parameters | |-----------|------------| | Date Range | Date From (required), Date To (optional) | | Receipt Number | Receipt Number | | Payment Slip Number | Payment Slip Number |

Finance Resource

Operations for financial transactions.

Get Receipt Types

Retrieve available receipt types. This is a GET request with no parameters.

Get Receipt Details

Retrieve details for a specific receipt.

| Parameter | Description | |-----------|-------------| | Receipt Number | Receipt number (required) |

Get Transactions

Retrieve financial transactions.

| Parameter | Description | |-----------|-------------| | Date From | Start date (required) | | Date To | End date (required) |

ARCA Resource

Operations for ARCA (Argentine Federal Administration of Public Revenue) documentation.

Get Waybills

Retrieve ARCA waybills (Carta de Porte - transport documents).

| Search By | Parameters | |-----------|------------| | Date Range | Date From (required), Date To (optional) | | CTG Number | CTG Number |

Validation

The node includes built-in validation:

• Date validation: Dates cannot be in the future and must be valid calendar dates
• Date range: Maximum range is 31 days (1 month) when both dates are provided
• Numeric fields: Required numeric fields (CTG Number, Broker Contract Number, etc.) must be greater than 0

Authentication

This node uses OAuth2 Password Grant flow for authentication. The access token is automatically obtained using your credentials and cached to optimize API calls.

The authentication flow:

1. On first request, the node obtains an access token from the /token endpoint
2. The token is cached in memory with a 60-second buffer before expiry
3. All API requests include the token in the Authorization: Bearer header
4. When the token expires, a new one is automatically requested

Compatibility

• n8n version: 1.0.0 or later
• Node.js version: 20.0.0 or later

Resources

• n8n Community Nodes Documentation
• FYO Website

Support

If you have questions or encounter issues:

• Open an issue on GitHub
• Contact FYO support at [email protected]

License

MIT