API de Autofactura

{
  "ticket": "TX-0001",
  "motivo": "Devolucion total o cancelacion en POS"
}

{
  "success": true,
  "ticket_id": 1042,
  "mode": "created",
  "portal_url": "https://tudominio.com/facturas/autofactura/?t=TOKEN&ticket=TX-0001",
  "request_id": "A3F9B12C"
}

curl -X POST https://tudominio.com/facturas/api/autofactura_webhook.php \
  -H "Authorization: Bearer afk_tu_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "ticket": "TX-0001",
    "fecha": "2026-03-21",
    "conceptos": [{
      "descripcion": "Cafe Americano",
      "clave_sat": "90111800",
      "clave_unit": "H87",
      "cantidad": 2,
      "precio_unitario": 45.00,
      "iva_tasa": 0.16
    }]
  }'

curl -X POST https://tudominio.com/facturas/api/facturar_directo.php \
  -H "Authorization: Bearer afk_tu_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "cliente_id": 42,
    "serie": "A", "folio": "1024",
    "metodo_pago": "PUE", "forma_pago": "03",
    "conceptos": [{
      "descripcion": "Desarrollo de Software",
      "clave_sat": "81111508",
      "clave_unit": "E48",
      "cantidad": 1,
      "precio": 15000.00,
      "iva_tipo": "tasa",
      "iva_tasa": 0.16
    }]
  }'

# Exito: {"success":true,"uuid":"CE890A12-...","message":"Factura timbrada con exito"}
# Error: {"success":false,"code":"STAMP_FAILED","finkok_code":"301","error":"[301] RFC invalido"}

<?php
$url     = 'https://tudominio.com/facturas/api/autofactura_webhook.php';
$api_key = 'afk_tu_api_key_aqui';

$payload = [
    'ticket'    => 'TX-0001',
    'fecha'     => '2026-03-21',
    'conceptos' => [[
        'descripcion'     => 'Café Americano',
        'clave_sat'       => '90111800',
        'clave_unit'      => 'H87',
        'cantidad'        => 2,
        'precio_unitario' => 45.00,
        'iva_tasa'        => 0.16,
    ]],
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $api_key,
        'Content-Type: application/json',
    ],
]);

$res  = curl_exec($ch);
$data = json_decode($res, true);
curl_close($ch);

if ($data['success']) {
    echo 'Portal: ' . $data['portal_url'];
} else {
    error_log('[facturamx] ' . $data['code'] . ' — ' . $data['error']);
}

<?php
$url     = 'https://tudominio.com/facturas/api/facturar_directo.php';
$api_key = 'afk_tu_api_key_aqui';

$payload = [
    'cliente_id'       => 42,
    'serie'            => 'A',
    'folio'            => '1024',
    'tipo_comprobante' => 'I',
    'metodo_pago'      => 'PUE',
    'forma_pago'       => '03',
    'conceptos' => [[
        'descripcion' => 'Desarrollo de Software',
        'clave_sat'   => '81111508',
        'clave_unit'  => 'E48',
        'cantidad'    => 1,
        'precio'      => 15000.00,
        'iva_tipo'    => 'tasa',
        'iva_tasa'    => 0.16,
    ]],
];

$ch = curl_init($url);
curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode($payload),
    CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $api_key, 'Content-Type: application/json',
    ],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

if ($data['success']) {
    echo 'UUID timbrado: ' . $data['uuid'];
} else {
    // $data['finkok_code'] disponible cuando code === 'STAMP_FAILED'
    $fcode = isset($data['finkok_code']) ? ' (Finkok ' . $data['finkok_code'] . ')' : '';
    error_log('[facturamx] ' . $data['code'] . $fcode . ' — ' . $data['error']);
}

// Node.js — fetch nativo (v18+)
const API_KEY = 'afk_tu_api_key_aqui';
const URL     = 'https://tudominio.com/facturas/api/autofactura_webhook.php';

const res  = await fetch(URL, {
  method:  'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type':  'application/json',
  },
  body: JSON.stringify({
    ticket: 'TX-0001',
    fecha:  '2026-03-21',
    conceptos: [{
      descripcion:     'Café Americano',
      clave_sat:       '90111800',
      clave_unit:      'H87',
      cantidad:        2,
      precio_unitario: 45.00,
      iva_tasa:        0.16,
    }],
  }),
});

const data = await res.json();

if (data.success) {
  console.log('Portal:', data.portal_url);
} else {
  console.error(`[${data.code}]`, data.error);
}

// Node.js — timbrado directo (fetch nativo v18+)
const res  = await fetch('https://tudominio.com/facturas/api/facturar_directo.php', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer afk_tu_api_key_aqui', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    cliente_id: 42, serie: 'A', folio: '1024', metodo_pago: 'PUE', forma_pago: '03',
    conceptos: [{
      descripcion: 'Desarrollo de Software', clave_sat: '81111508', clave_unit: 'E48',
      cantidad: 1, precio: 15000, iva_tipo: 'tasa', iva_tasa: 0.16,
    }],
  }),
});
const data = await res.json();
if (data.success) {
  console.log('UUID:', data.uuid);
} else {
  // finkok_code presente cuando el SAT/Finkok rechaza
  const fcode = data.finkok_code ? ` (Finkok ${data.finkok_code})` : '';
  console.error(`[${data.code}${fcode}]`, data.error);
}

import requests

API_KEY = "afk_tu_api_key_aqui"
URL     = "https://tudominio.com/facturas/api/autofactura_webhook.php"

payload = {
    "ticket": "TX-0001",
    "fecha":  "2026-03-21",
    "conceptos": [{
        "descripcion":     "Café Americano",
        "clave_sat":       "90111800",
        "clave_unit":      "H87",
        "cantidad":        2,
        "precio_unitario": 45.00,
        "iva_tasa":        0.16,
    }],
}

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

r    = requests.post(URL, json=payload, headers=headers, timeout=10)
data = r.json()

if data["success"]:
    # Enviar data["portal_url"] al cliente
    print("Portal:", data["portal_url"])
else:
    print(f"[{data['code']}]", data["error"])

import requests

data = requests.post(
    "https://tudominio.com/facturas/api/facturar_directo.php",
    headers={"Authorization": "Bearer afk_tu_api_key_aqui", "Content-Type": "application/json"},
    json={
        "cliente_id": 42, "serie": "A", "folio": "1024",
        "metodo_pago": "PUE", "forma_pago": "03",
        "conceptos": [{
            "descripcion": "Desarrollo de Software", "clave_sat": "81111508",
            "clave_unit": "E48", "cantidad": 1, "precio": 15000.0,
            "iva_tipo": "tasa", "iva_tasa": 0.16,
        }],
    }, timeout=30,
).json()

if data["success"]:
    print("UUID timbrado:", data["uuid"])
else:
    # finkok_code presente cuando STAMP_FAILED
    fcode = data.get("finkok_code", "")
    print(f"[{data['code']}{' Finkok ' + fcode if fcode else ''}]", data["error"])