Documentación Técnica: API de Integración ERP / TPV

curl -X POST "https://api.fideclien.com/v1/erp/purchases" \
     -H "Authorization: Bearer token_live_E8W6A••••••••••••••••••••••••••••••••" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{
       "customer": {
         "identifier": "612345678",
         "type": "phone"
       },
       "amount": 35.50,
       "category": "Alimentación",
       "ticket": {
         "codigo_ticket": "TK-2026-99081",
         "precio_final": 35.50,
         "lista_articulos": [
           {
             "nombre": "Aceite de Oliva Virgen Extra 1L",
             "cantidad": 2,
             "precio_unidad": 15.00,
             "precio_total": 30.00
           },
           {
             "nombre": "Sal Marina 1kg",
             "cantidad": 1,
             "precio_unidad": 5.50,
             "precio_total": 5.50
           }
         ]
       }
     }'

using System;
using System.Net.Http;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;

public class ErpRetailClient
{
    private static readonly HttpClient client = new HttpClient();
    private const string ApiUrl = "https://api.fideclien.com/v1/erp/purchases";
    private const string Token = "token_live_E8W6A••••••••••••••••••••••••••••••••";

    public static async Task RegistrarVentaAsync(string telefono, decimal importe, string ticketNumero)
    {
        client.DefaultRequestHeaders.Clear();
        client.DefaultRequestHeaders.Add("Authorization", $"Bearer {Token}");

        var payloadObj = new
        {
            customer = new { identifier = telefono, type = "phone" },
            amount = importe,
            category = "Alimentación",
            ticket = new
            {
                codigo_ticket = ticketNumero,
                precio_final = importe,
                lista_articulos = new[]
                {
                    new { nombre = "Aceite de Oliva Virgen Extra 1L", cantidad = 2, precio_unidad = 15.00m, precio_total = 30.00m },
                    new { nombre = "Sal Marina 1kg", cantidad = 1, precio_unidad = 5.50m, precio_total = 5.50m }
                }
            }
        };

        string jsonPayload = JsonSerializer.Serialize(payloadObj);
        var content = new StringContent(jsonPayload, Encoding.UTF8, "application/json");
        var response = await client.PostAsync(ApiUrl, content);
        string result = await response.Content.ReadAsStringAsync();
        Console.WriteLine($"Respuesta: {response.StatusCode} - {result}");
    }
}

import requests

API_URL = "https://api.fideclien.com/v1/erp/purchases"
TOKEN = "token_live_E8W6A••••••••••••••••••••••••••••••••"

headers = {
    "Authorization": f"Bearer {TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json"
}

payload = {
    "customer": {
        "identifier": "612345678",
        "type": "phone"
    },
    "amount": 35.50,
    "category": "Alimentación",
    "ticket": {
        "codigo_ticket": "TK-2026-99081",
        "precio_final": 35.50,
        "lista_articulos": [
            {
                "nombre": "Aceite de Oliva Virgen Extra 1L",
                "cantidad": 2,
                "precio_unidad": 15.00,
                "precio_total": 30.00
            },
            {
                "nombre": "Sal Marina 1kg",
                "cantidad": 1,
                "precio_unidad": 5.50,
                "precio_total": 5.50
            }
        ]
    }
}

response = requests.post(API_URL, json=payload, headers=headers)
print(response.status_code, response.json())

<?php

$ch = curl_init('https://api.fideclien.com/v1/erp/purchases');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer token_live_E8W6A••••••••••••••••••••••••••••••••',
        'Content-Type: application/json',
        'Accept: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'customer' => ['identifier' => '612345678', 'type' => 'phone'],
        'amount' => 35.50,
        'category' => 'Alimentación',
        'ticket' => [
            'codigo_ticket' => 'TK-2026-99081',
            'precio_final' => 35.50,
            'lista_articulos' => [
                [
                    'nombre' => 'Aceite de Oliva Virgen Extra 1L',
                    'cantidad' => 2,
                    'precio_unidad' => 15.00,
                    'precio_total' => 30.00
                ],
                [
                    'nombre' => 'Sal Marina 1kg',
                    'cantidad' => 1,
                    'precio_unidad' => 5.50,
                    'precio_total' => 5.50
                ]
            ]
        ]
    ])
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo "HTTP {$httpCode}: {$response}\n";