Documentación API REST

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://facepro.cdpconsultores.com/api/v1/me

<?php
$ch = curl_init('https://facepro.cdpconsultores.com/api/v1/me');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_TOKEN',
    'Accept: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data['tenant']);

Imports System.Net.Http
Imports System.Net.Http.Headers
Imports Newtonsoft.Json.Linq

Dim cliente As New HttpClient()
cliente.DefaultRequestHeaders.Authorization =
    New AuthenticationHeaderValue("Bearer", "YOUR_TOKEN")

Dim respuesta = Await cliente.GetAsync("https://facepro.cdpconsultores.com/api/v1/me")
Dim cuerpo = Await respuesta.Content.ReadAsStringAsync()
Dim json = JObject.Parse(cuerpo)

Console.WriteLine("Empresa: " & json("tenant")("razon_social").ToString())

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "YOUR_TOKEN");

var response = await client.GetAsync("https://facepro.cdpconsultores.com/api/v1/me");
var body = await response.Content.ReadAsStringAsync();
var data = JsonSerializer.Deserialize<JsonElement>(body);

Console.WriteLine(data.GetProperty("tenant").GetProperty("razon_social"));

const response = await fetch('https://facepro.cdpconsultores.com/api/v1/me', {
  headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
});
const data = await response.json();
console.log(data.tenant.razon_social);

curl -X POST https://facepro.cdpconsultores.com/api/v1/documentos \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "adquiriente": {
      "tipo_persona": "2",
      "tipo_documento": "13",
      "numero_documento": "71234567",
      "razon_social": "JUAN PEREZ",
      "responsabilidad_fiscal": "R-99-PN"
    },
    "lineas": [
      { "codigo": "P1", "descripcion": "Producto 1",
        "cantidad": 2, "precio": 50000, "iva_pct": 19 }
    ]
  }'

<?php
$datos = [
    'adquiriente' => [
        'tipo_persona'           => '2',
        'tipo_documento'         => '13',
        'numero_documento'       => '71234567',
        'razon_social'           => 'JUAN PEREZ',
        'responsabilidad_fiscal' => 'R-99-PN',
    ],
    'lineas' => [
        [
            'codigo'      => 'P1',
            'descripcion' => 'Producto 1',
            'cantidad'    => 2,
            'precio'      => 50000,
            'iva_pct'     => 19,
        ],
    ],
];

$ch = curl_init('https://facepro.cdpconsultores.com/api/v1/documentos');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($datos));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_TOKEN',
    'Content-Type: application/json',
    'Accept: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$status   = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
if ($status === 201) {
    echo "CUFE: " . $result['data']['cufe'] . "\n";
    echo "Estado: " . $result['data']['estado'] . "\n";
} else {
    echo "Error: " . $result['error'] . "\n";
}

Imports System.Net.Http
Imports System.Net.Http.Headers
Imports System.Text
Imports Newtonsoft.Json
Imports Newtonsoft.Json.Linq

Dim datos = New With {
    .adquiriente = New With {
        .tipo_persona = "2",
        .tipo_documento = "13",
        .numero_documento = "71234567",
        .razon_social = "JUAN PEREZ",
        .responsabilidad_fiscal = "R-99-PN"
    },
    .lineas = {
        New With {
            .codigo = "P1",
            .descripcion = "Producto 1",
            .cantidad = 2,
            .precio = 50000,
            .iva_pct = 19
        }
    }
}

Dim json = JsonConvert.SerializeObject(datos)
Dim contenido As New StringContent(json, Encoding.UTF8, "application/json")

Dim cliente As New HttpClient()
cliente.DefaultRequestHeaders.Authorization =
    New AuthenticationHeaderValue("Bearer", "YOUR_TOKEN")

Dim respuesta = Await cliente.PostAsync("https://facepro.cdpconsultores.com/api/v1/documentos", contenido)
Dim cuerpo = Await respuesta.Content.ReadAsStringAsync()
Dim resultado = JObject.Parse(cuerpo)

If respuesta.IsSuccessStatusCode Then
    Console.WriteLine("CUFE: " & resultado("data")("cufe").ToString())
    Console.WriteLine("Estado: " & resultado("data")("estado").ToString())
Else
    Console.WriteLine("Error: " & resultado("error").ToString())
End If

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;

var datos = new {
    adquiriente = new {
        tipo_persona = "2",
        tipo_documento = "13",
        numero_documento = "71234567",
        razon_social = "JUAN PEREZ",
        responsabilidad_fiscal = "R-99-PN"
    },
    lineas = new[] {
        new {
            codigo = "P1",
            descripcion = "Producto 1",
            cantidad = 2,
            precio = 50000,
            iva_pct = 19
        }
    }
};

var json = JsonSerializer.Serialize(datos);
var content = new StringContent(json, Encoding.UTF8, "application/json");

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "YOUR_TOKEN");

var response = await client.PostAsync("https://facepro.cdpconsultores.com/api/v1/documentos", content);
var body = await response.Content.ReadAsStringAsync();
var result = JsonDocument.Parse(body).RootElement;

if (response.IsSuccessStatusCode) {
    Console.WriteLine("CUFE: " + result.GetProperty("data").GetProperty("cufe"));
    Console.WriteLine("Estado: " + result.GetProperty("data").GetProperty("estado"));
} else {
    Console.WriteLine("Error: " + result.GetProperty("error"));
}

const datos = {
  adquiriente: {
    tipo_persona: '2',
    tipo_documento: '13',
    numero_documento: '71234567',
    razon_social: 'JUAN PEREZ',
    responsabilidad_fiscal: 'R-99-PN'
  },
  lineas: [
    { codigo: 'P1', descripcion: 'Producto 1',
      cantidad: 2, precio: 50000, iva_pct: 19 }
  ]
};

const response = await fetch('https://facepro.cdpconsultores.com/api/v1/documentos', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'Content-Type': 'application/json',
    'Accept': 'application/json'
  },
  body: JSON.stringify(datos)
});

const result = await response.json();
if (response.ok) {
  console.log('CUFE:', result.data.cufe);
  console.log('Estado:', result.data.estado);
} else {
  console.error('Error:', result.error);
}

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://facepro.cdpconsultores.com/api/v1/documentos?estado=aceptado&desde=2026-05-01&per_page=50"

<?php
$query = http_build_query([
    'estado'   => 'aceptado',
    'desde'    => '2026-05-01',
    'per_page' => 50,
]);

$ch = curl_init('https://facepro.cdpconsultores.com/api/v1/documentos?' . $query);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_TOKEN',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
foreach ($data['data'] as $doc) {
    echo $doc['numero_completo'] . ' - ' . $doc['estado'] . PHP_EOL;
}

Dim cliente As New HttpClient()
cliente.DefaultRequestHeaders.Authorization =
    New AuthenticationHeaderValue("Bearer", "YOUR_TOKEN")

Dim url = "https://facepro.cdpconsultores.com/api/v1/documentos?estado=aceptado&desde=2026-05-01&per_page=50"
Dim respuesta = Await cliente.GetAsync(url)
Dim cuerpo = Await respuesta.Content.ReadAsStringAsync()
Dim json = JObject.Parse(cuerpo)

For Each doc In json("data")
    Console.WriteLine(doc("numero_completo") & " - " & doc("estado"))
Next

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "YOUR_TOKEN");

var url = "https://facepro.cdpconsultores.com/api/v1/documentos?estado=aceptado&desde=2026-05-01&per_page=50";
var response = await client.GetAsync(url);
var body = await response.Content.ReadAsStringAsync();
var data = JsonDocument.Parse(body).RootElement;

foreach (var doc in data.GetProperty("data").EnumerateArray())
{
    Console.WriteLine(doc.GetProperty("numero_completo") + " - " + doc.GetProperty("estado"));
}

const params = new URLSearchParams({
  estado: 'aceptado',
  desde: '2026-05-01',
  per_page: 50
});

const response = await fetch(`https://facepro.cdpconsultores.com/api/v1/documentos?${params}`, {
  headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
});
const data = await response.json();

data.data.forEach(doc => {
  console.log(`${doc.numero_completo} - ${doc.estado}`);
});

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://facepro.cdpconsultores.com/api/v1/documentos/550e8400-e29b-41d4-a716-446655440000

<?php
$trackingId = '550e8400-e29b-41d4-a716-446655440000';

$ch = curl_init("https://facepro.cdpconsultores.com/api/v1/documentos/{$trackingId}");
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer YOUR_TOKEN']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$doc = json_decode($response, true);
echo "Estado: " . $doc['estado'];

Dim trackingId = "550e8400-e29b-41d4-a716-446655440000"
Dim cliente As New HttpClient()
cliente.DefaultRequestHeaders.Authorization =
    New AuthenticationHeaderValue("Bearer", "YOUR_TOKEN")

Dim respuesta = Await cliente.GetAsync("https://facepro.cdpconsultores.com/api/v1/documentos/" & trackingId)
Dim cuerpo = Await respuesta.Content.ReadAsStringAsync()
Dim doc = JObject.Parse(cuerpo)

Console.WriteLine("Estado: " & doc("estado"))

var trackingId = "550e8400-e29b-41d4-a716-446655440000";
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "YOUR_TOKEN");

var response = await client.GetAsync($"https://facepro.cdpconsultores.com/api/v1/documentos/{trackingId}");
var body = await response.Content.ReadAsStringAsync();
var doc = JsonDocument.Parse(body).RootElement;

Console.WriteLine("Estado: " + doc.GetProperty("estado"));

const trackingId = '550e8400-e29b-41d4-a716-446655440000';

const response = await fetch(`https://facepro.cdpconsultores.com/api/v1/documentos/${trackingId}`, {
  headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
});
const doc = await response.json();
console.log('Estado:', doc.estado);

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://facepro.cdpconsultores.com/api/v1/documentos/550e8400-.../consultar

<?php
$ch = curl_init("https://facepro.cdpconsultores.com/api/v1/documentos/{$trackingId}/consultar");
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer YOUR_TOKEN']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$res = json_decode($response, true);
echo $res['dian']['status_description'];

Dim respuesta = Await cliente.GetAsync("https://facepro.cdpconsultores.com/api/v1/documentos/" & trackingId & "/consultar")
Dim cuerpo = Await respuesta.Content.ReadAsStringAsync()
Dim json = JObject.Parse(cuerpo)
Console.WriteLine(json("dian")("status_description"))

var response = await client.GetAsync($"https://facepro.cdpconsultores.com/api/v1/documentos/{trackingId}/consultar");
var body = await response.Content.ReadAsStringAsync();
var res = JsonDocument.Parse(body).RootElement;
Console.WriteLine(res.GetProperty("dian").GetProperty("status_description"));

const response = await fetch(`https://facepro.cdpconsultores.com/api/v1/documentos/${trackingId}/consultar`, {
  headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
});
const res = await response.json();
console.log(res.dian.status_description);

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://facepro.cdpconsultores.com/api/v1/documentos/550e8400-.../xml \
  -o factura.xml

<?php
$ch = curl_init("https://facepro.cdpconsultores.com/api/v1/documentos/{$trackingId}/xml");
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer YOUR_TOKEN']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$xml = curl_exec($ch);
curl_close($ch);

file_put_contents('factura.xml', $xml);

Dim respuesta = Await cliente.GetAsync("https://facepro.cdpconsultores.com/api/v1/documentos/" & trackingId & "/xml")
Dim xml = Await respuesta.Content.ReadAsStringAsync()
File.WriteAllText("factura.xml", xml)

var response = await client.GetAsync($"https://facepro.cdpconsultores.com/api/v1/documentos/{trackingId}/xml");
var xml = await response.Content.ReadAsStringAsync();
File.WriteAllText("factura.xml", xml);

const response = await fetch(`https://facepro.cdpconsultores.com/api/v1/documentos/${trackingId}/xml`, {
  headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
});
const xml = await response.text();
// xml contiene el UBL firmado

curl -X POST https://facepro.cdpconsultores.com/api/v1/notas-credito \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "factura_referencia": {
      "numero": "SETP990000011",
      "cufe":   "a1b2c3...",
      "fecha":  "2026-05-10"
    },
    "motivo": { "codigo": "2", "descripcion": "Anulación" },
    "adquiriente": { ... },
    "lineas": [ ... ]
  }'

<?php
$datos = [
    'factura_referencia' => [
        'numero' => 'SETP990000011',
        'cufe'   => 'a1b2c3d4...',
        'fecha'  => '2026-05-10',
    ],
    'motivo' => [
        'codigo'      => '2',
        'descripcion' => 'Anulación por error en valor unitario',
    ],
    'adquiriente' => [ /* ... */ ],
    'lineas'      => [ /* ... */ ],
];

$ch = curl_init('https://facepro.cdpconsultores.com/api/v1/notas-credito');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($datos));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_TOKEN',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

Dim datos = New With {
    .factura_referencia = New With {
        .numero = "SETP990000011",
        .cufe   = "a1b2c3d4...",
        .fecha  = "2026-05-10"
    },
    .motivo = New With { .codigo = "2", .descripcion = "Anulación" },
    .adquiriente = New With { },
    .lineas = { }
}

Dim json = JsonConvert.SerializeObject(datos)
Dim contenido As New StringContent(json, Encoding.UTF8, "application/json")
Dim respuesta = Await cliente.PostAsync("https://facepro.cdpconsultores.com/api/v1/notas-credito", contenido)

var datos = new {
    factura_referencia = new {
        numero = "SETP990000011",
        cufe   = "a1b2c3d4...",
        fecha  = "2026-05-10"
    },
    motivo = new { codigo = "2", descripcion = "Anulación" },
    adquiriente = new { /* ... */ },
    lineas = new[] { /* ... */ }
};

var json = JsonSerializer.Serialize(datos);
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://facepro.cdpconsultores.com/api/v1/notas-credito", content);

const datos = {
  factura_referencia: {
    numero: 'SETP990000011',
    cufe:   'a1b2c3d4...',
    fecha:  '2026-05-10'
  },
  motivo: { codigo: '2', descripcion: 'Anulación' },
  adquiriente: { /* ... */ },
  lineas: [ /* ... */ ]
};

const response = await fetch('https://facepro.cdpconsultores.com/api/v1/notas-credito', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(datos)
});
const result = await response.json();

curl -X POST https://facepro.cdpconsultores.com/api/v1/notas-debito \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "factura_referencia": { "numero": "SETP990000011", "cufe": "...", "fecha": "2026-05-10" },
    "motivo": { "codigo": "1", "descripcion": "Intereses por mora" },
    "adquiriente": { ... },
    "lineas": [ ... ]
  }'

<?php
$datos = [
    'factura_referencia' => [ 'numero'=>'SETP990000011', 'cufe'=>'...', 'fecha'=>'2026-05-10' ],
    'motivo'             => [ 'codigo'=>'1', 'descripcion'=>'Intereses por mora' ],
    'adquiriente'        => [ /* ... */ ],
    'lineas'             => [ /* ... */ ],
];

$ch = curl_init('https://facepro.cdpconsultores.com/api/v1/notas-debito');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($datos));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_TOKEN',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

Dim datos = New With {
    .factura_referencia = New With { .numero = "SETP990000011", .cufe = "...", .fecha = "2026-05-10" },
    .motivo = New With { .codigo = "1", .descripcion = "Intereses por mora" },
    .adquiriente = New With { },
    .lineas = { }
}

Dim json = JsonConvert.SerializeObject(datos)
Dim contenido As New StringContent(json, Encoding.UTF8, "application/json")
Dim respuesta = Await cliente.PostAsync("https://facepro.cdpconsultores.com/api/v1/notas-debito", contenido)

var datos = new {
    factura_referencia = new { numero = "SETP990000011", cufe = "...", fecha = "2026-05-10" },
    motivo = new { codigo = "1", descripcion = "Intereses por mora" },
    adquiriente = new { /* ... */ },
    lineas = new[] { /* ... */ }
};

var json = JsonSerializer.Serialize(datos);
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://facepro.cdpconsultores.com/api/v1/notas-debito", content);

const datos = {
  factura_referencia: { numero: 'SETP990000011', cufe: '...', fecha: '2026-05-10' },
  motivo: { codigo: '1', descripcion: 'Intereses por mora' },
  adquiriente: { /* ... */ },
  lineas: [ /* ... */ ]
};

const response = await fetch('https://facepro.cdpconsultores.com/api/v1/notas-debito', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer YOUR_TOKEN', 'Content-Type': 'application/json' },
  body: JSON.stringify(datos)
});
const result = await response.json();