OTTO Market icon

OTTO Market

Consume OTTO Market API

Actions4

Overview

This node integrates with the OTTO Market API to manage return requests. Specifically, for the "Return" resource and the "Accept Return" operation, it allows users to accept returned items by sending a list of received items back to the OTTO Market system. This is useful in e-commerce workflows where returns need to be processed automatically after receiving items from customers or partners.

Practical examples include:

  • Automatically confirming acceptance of returned products once they arrive at your warehouse.
  • Updating the OTTO Market system with details of returned items to trigger refunds or restocking.

Properties

Name Meaning
Position Items (Json) A JSON array listing all the items received from the partner as part of the return. This should contain detailed information about each returned item to be accepted.

Output

The node outputs a JSON array where each element contains a data field holding the response from the OTTO Market API after accepting the return. This response typically includes confirmation details about the accepted return positions.

No binary data output is produced by this operation.

Example output structure:

[
  {
    "data": {
      // API response confirming accepted return items
    }
  }
]

Dependencies

  • Requires an active connection to the OTTO Market API using an API key credential configured in n8n.
  • The node depends on the OTTO Market API endpoints /v2/returns/acceptance for accepting returns.
  • Proper network access and authentication credentials must be set up in n8n for successful API communication.

Troubleshooting

  • Common issues:

    • Invalid or malformed JSON in the "Position Items (Json)" property can cause request failures.
    • Missing or incorrect API credentials will result in authentication errors.
    • Network connectivity problems may prevent reaching the OTTO Market API.

  • Error messages:

    • Authentication errors typically indicate invalid or missing API keys; verify credentials in n8n settings.
    • Validation errors from the API may occur if the position items data does not conform to expected schema; ensure the JSON structure matches OTTO Market's requirements.
    • HTTP errors like 4xx or 5xx suggest issues with the request or server; check the API documentation and retry later if needed.

Links and References

Discussion