TroyanSys Isotipo TroyanSys ERP Docs API

Guia rapida de integracion

Actualizado con los endpoints activos de la plataforma. Total disponibles: 73.

Contexto Header requerido Uso
Usuario cliente (Bearer) Authorization: Bearer {token}
X-Company-Id: {id}		 Apps moviles y sesiones por usuario.
Empresa (API Key) X-API-Key: {api_key_empresa} Integraciones server-to-server.
Base URL https://troyansys.com/api/v1 Todos los endpoints documentados usan este prefijo.

Codigos HTTP esperados

200/201 exito, 401 auth invalida, 403 modulo/tenant restringido, 422 validacion.

Flujo factura API

POST /documents/invoices: crea comprobante, valida stock y ejecuta flujo SRI/email segun configuracion de empresa.

Documentacion segmentada

Cada modulo muestra sus metodos, payloads, ejemplos cURL/PHP/.NET y respuesta esperada.

Autenticacion 6 metodos Base de conocimiento 3 metodos Inventario 6 metodos Ventas 10 metodos Compras 4 metodos Contabilidad 5 metodos Reporteria 5 metodos

Compras

Consulta de proveedores y comprobantes de compra con trazabilidad de conversion.

Base URL: https://troyansys.com/api/v1

GET

Listar proveedores

Obtiene proveedores paginados.

Endpoint Bearer
https://troyansys.com/api/v1/suppliers
Endpoint API Key
https://troyansys.com/api/v1/company/suppliers

Parametros Query

Campo Tipo Req. Descripcion
per_page integer No Cantidad por pagina.
search string No Filtro por codigo, nombre o identificacion.
status string No active o inactive.

Ejemplos de uso

Bearer
cURL 
curl -X GET "https://troyansys.com/api/v1/suppliers?per_page=20&search=industrial" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}" \
  -H "X-Company-Id: 1"
PHP (Guzzle) 
<?php

$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://troyansys.com/api/v1/suppliers?per_page=20&search=industrial', [
    'headers' => [
        'Accept' => 'application/json',
        'Authorization' => 'Bearer {token}',
        'X-Company-Id' => '1'
    ],
]);

$data = json_decode((string) $response->getBody(), true);
print_r($data);
.NET (HttpClient) 
using System.Net.Http.Headers;
using System.Text;

var httpClient = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://troyansys.com/api/v1/suppliers?per_page=20&search=industrial");
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", "{token}");
request.Headers.Add("X-Company-Id", "1");

var response = await httpClient.SendAsync(request);
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
API Key
cURL 
curl -X GET "https://troyansys.com/api/v1/company/suppliers?per_page=20&search=industrial" \
  -H "Accept: application/json" \
  -H "X-API-Key: {api_key_empresa}"
PHP (Guzzle) 
<?php

$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://troyansys.com/api/v1/company/suppliers?per_page=20&search=industrial', [
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => '{api_key_empresa}'
    ],
]);

$data = json_decode((string) $response->getBody(), true);
print_r($data);
.NET (HttpClient) 
using System.Net.Http.Headers;
using System.Text;

var httpClient = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://troyansys.com/api/v1/company/suppliers?per_page=20&search=industrial");
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
request.Headers.Add("X-API-Key", "{api_key_empresa}");

var response = await httpClient.SendAsync(request);
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Respuesta esperada

{
    "current_page": 1,
    "data": [
        {
            "id": 7,
            "code": "PRV-007",
            "name": "Proveedor Industrial",
            "is_active": true
        }
    ]
}
GET

Ver proveedor

Obtiene detalle de proveedor.

Endpoint Bearer
https://troyansys.com/api/v1/suppliers/7
Endpoint API Key
https://troyansys.com/api/v1/company/suppliers/7

Ejemplos de uso

Bearer
cURL 
curl -X GET "https://troyansys.com/api/v1/suppliers/7" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}" \
  -H "X-Company-Id: 1"
PHP (Guzzle) 
<?php

$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://troyansys.com/api/v1/suppliers/7', [
    'headers' => [
        'Accept' => 'application/json',
        'Authorization' => 'Bearer {token}',
        'X-Company-Id' => '1'
    ],
]);

$data = json_decode((string) $response->getBody(), true);
print_r($data);
.NET (HttpClient) 
using System.Net.Http.Headers;
using System.Text;

var httpClient = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://troyansys.com/api/v1/suppliers/7");
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", "{token}");
request.Headers.Add("X-Company-Id", "1");

var response = await httpClient.SendAsync(request);
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
API Key
cURL 
curl -X GET "https://troyansys.com/api/v1/company/suppliers/7" \
  -H "Accept: application/json" \
  -H "X-API-Key: {api_key_empresa}"
PHP (Guzzle) 
<?php

$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://troyansys.com/api/v1/company/suppliers/7', [
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => '{api_key_empresa}'
    ],
]);

$data = json_decode((string) $response->getBody(), true);
print_r($data);
.NET (HttpClient) 
using System.Net.Http.Headers;
using System.Text;

var httpClient = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://troyansys.com/api/v1/company/suppliers/7");
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
request.Headers.Add("X-API-Key", "{api_key_empresa}");

var response = await httpClient.SendAsync(request);
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Respuesta esperada

{
    "id": 7,
    "code": "PRV-007",
    "name": "Proveedor Industrial",
    "identification": "0999999999001",
    "email": "contacto@proveedor.ec"
}
GET

Listar comprobantes de compra

Obtiene comprobantes de compra paginados.

Endpoint Bearer
https://troyansys.com/api/v1/purchase-documents
Endpoint API Key
https://troyansys.com/api/v1/company/purchase-documents

Parametros Query

Campo Tipo Req. Descripcion
per_page integer No Cantidad por pagina.
type string No purchase_order o supplier_invoice.
status string No draft, issued o cancelled.
supplier_id integer No Filtro por proveedor.
date_from date No Desde YYYY-MM-DD.
date_to date No Hasta YYYY-MM-DD.

Ejemplos de uso

Bearer
cURL 
curl -X GET "https://troyansys.com/api/v1/purchase-documents?per_page=20&type=supplier_invoice" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}" \
  -H "X-Company-Id: 1"
PHP (Guzzle) 
<?php

$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://troyansys.com/api/v1/purchase-documents?per_page=20&type=supplier_invoice', [
    'headers' => [
        'Accept' => 'application/json',
        'Authorization' => 'Bearer {token}',
        'X-Company-Id' => '1'
    ],
]);

$data = json_decode((string) $response->getBody(), true);
print_r($data);
.NET (HttpClient) 
using System.Net.Http.Headers;
using System.Text;

var httpClient = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://troyansys.com/api/v1/purchase-documents?per_page=20&type=supplier_invoice");
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", "{token}");
request.Headers.Add("X-Company-Id", "1");

var response = await httpClient.SendAsync(request);
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
API Key
cURL 
curl -X GET "https://troyansys.com/api/v1/company/purchase-documents?per_page=20&type=supplier_invoice" \
  -H "Accept: application/json" \
  -H "X-API-Key: {api_key_empresa}"
PHP (Guzzle) 
<?php

$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://troyansys.com/api/v1/company/purchase-documents?per_page=20&type=supplier_invoice', [
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => '{api_key_empresa}'
    ],
]);

$data = json_decode((string) $response->getBody(), true);
print_r($data);
.NET (HttpClient) 
using System.Net.Http.Headers;
using System.Text;

var httpClient = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://troyansys.com/api/v1/company/purchase-documents?per_page=20&type=supplier_invoice");
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
request.Headers.Add("X-API-Key", "{api_key_empresa}");

var response = await httpClient.SendAsync(request);
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Respuesta esperada

{
    "current_page": 1,
    "data": [
        {
            "id": 33,
            "type": "supplier_invoice",
            "series": "001-001",
            "number": "000000041",
            "total": "550.1200"
        }
    ]
}
GET

Ver comprobante de compra

Obtiene detalle con items, proveedor, bodega y documento origen de conversion.

Endpoint Bearer
https://troyansys.com/api/v1/purchase-documents/33
Endpoint API Key
https://troyansys.com/api/v1/company/purchase-documents/33

Ejemplos de uso

Bearer
cURL 
curl -X GET "https://troyansys.com/api/v1/purchase-documents/33" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}" \
  -H "X-Company-Id: 1"
PHP (Guzzle) 
<?php

$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://troyansys.com/api/v1/purchase-documents/33', [
    'headers' => [
        'Accept' => 'application/json',
        'Authorization' => 'Bearer {token}',
        'X-Company-Id' => '1'
    ],
]);

$data = json_decode((string) $response->getBody(), true);
print_r($data);
.NET (HttpClient) 
using System.Net.Http.Headers;
using System.Text;

var httpClient = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://troyansys.com/api/v1/purchase-documents/33");
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", "{token}");
request.Headers.Add("X-Company-Id", "1");

var response = await httpClient.SendAsync(request);
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
API Key
cURL 
curl -X GET "https://troyansys.com/api/v1/company/purchase-documents/33" \
  -H "Accept: application/json" \
  -H "X-API-Key: {api_key_empresa}"
PHP (Guzzle) 
<?php

$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://troyansys.com/api/v1/company/purchase-documents/33', [
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => '{api_key_empresa}'
    ],
]);

$data = json_decode((string) $response->getBody(), true);
print_r($data);
.NET (HttpClient) 
using System.Net.Http.Headers;
using System.Text;

var httpClient = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://troyansys.com/api/v1/company/purchase-documents/33");
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
request.Headers.Add("X-API-Key", "{api_key_empresa}");

var response = await httpClient.SendAsync(request);
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Respuesta esperada

{
    "id": 33,
    "type": "supplier_invoice",
    "series": "001-001",
    "number": "000000041",
    "status": "issued",
    "supplier": {
        "id": 7,
        "name": "Proveedor Industrial",
        "identification": "0999999999001"
    },
    "warehouse": {
        "id": 1,
        "name": "Bodega Principal"
    },
    "items": [
        {
            "id": 2,
            "product_id": 10,
            "description": "Lapiz HB",
            "quantity": "20.000"
        }
    ]
}