API de Factura Electrónica en Costa Rica

<?php
// Para que se vea en el navegador formateado el texto
header("Content-Type: text/plain; charset=UTF-8");

/**
 * Ejemplo 1: Factura Formato Pequeño - Una Línea
 * FACTURATica.com API
 */

$api_url = 'https://SU-DOMINIO-PANEL/_api.php';

$data = [
    'ACTION' => 'TIMBRAR_FACTURA',
    'CORREO' => 'correo@licencia.com',
    'API_KEY' => '8YQ...',
    'IDENTIFICACION' => '101110111',
];

/********************************************************************************
 * BLOQUE DE PRUEBAS                                                            *
 * Este bloque se utiliza para cargar datos de prueba durante el desarrollo.    *
 * Puede eliminarse sin problema alguno                                         *
 ********************************************************************************/
if (file_exists('datos_prueba.php')) {
    require_once 'datos_prueba.php';
}
/********************************************************************************
 * FIN DEL BLOQUE DE PRUEBAS                                                    *
 ********************************************************************************/

// Construir líneas de detalle
$lineas = [
    [
        "NumeroLinea" => "1",
        "Cantidad" => "1.00",
        "UnidadMedida" => "Unid",
        "Detalle" => "Servicio de consultoría mensual",
        "PrecioUnitario" => "250000.00",
        "MontoTotal" => "250000.00",
        "SubTotal" => "250000.00",
        "Codigo" => "01",
        "Tarifa" => "13",
        "Monto" => "32500.00",
        "MontoTotalLinea" => "282500.00"
    ]
];

$data +=[
    // Datos del receptor
    'RECEPTOR_NUMERO' => '3101360759',
    
    // Líneas de detalle
    'LINEAS' => json_encode($lineas),
    
    // Totales
    'SUBTOTAL' => 250000.00,
    'IV' => 32500.00,
    'TOTALIVI' => 282500.00,
    
    // Condiciones comerciales
    'CONDICIONVENTA' => '01',  // Contado
    'MEDIOPAGO' => '04',       // Transferencia
    'CODIGOMONEDA' => 'CRC',
];

// Ejecutar petición
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

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

// Mostrar respuesta
echo "==============================================n";
echo "EJEMPLO 1: Factura - Una Línean";
echo "==============================================n";
echo "HTTP Code: " . $http_code . "n";
echo "Respuesta: " . $response . "n";

// Si la respuesta es una clave de 50 caracteres, fue exitoso
if (strlen($response) == 50) {
    echo "n✓ FACTURA TIMBRADA EXITOSAMENTEn";
    echo "Clave: " . $response . "n";
} else {
    echo "n✗ ERROR EN EL TIMBRAJEn";
}
?>

<?php
// Para que se vea en el navegador formateado el texto
header("Content-Type: text/plain; charset=UTF-8");

/**
 * Ejemplo 2: Factura Formato Carta - Múltiples Líneas con Diferentes IVAs
 * FACTURATica.com API
 */

$api_url = 'https://SU-DOMINIO-PANEL/_api.php';

$data = [
    'ACTION' => 'TIMBRAR_FACTURA',
    'CORREO' => 'correo@licencia.com',
    'API_KEY' => '8YQ...',
    'IDENTIFICACION' => '101110111',
    
];

/********************************************************************************
 * BLOQUE DE PRUEBAS                                                            *
 * Este bloque se utiliza para cargar datos de prueba durante el desarrollo.    *
 * Puede eliminarse sin problema alguno                                         *
 ********************************************************************************/
if (file_exists('datos_prueba.php')) {
    require_once 'datos_prueba.php';
}
/********************************************************************************
 * FIN DEL BLOQUE DE PRUEBAS                                                    *
 ********************************************************************************/

// Construir líneas de detalle con diferentes tarifas de IVA
$lineas = [
    [
        "NumeroLinea" => "1",
        "Cantidad" => "10.00",
        "UnidadMedida" => "Unid",
        "Detalle" => "Producto gravado con IVA 13%",
        "PrecioUnitario" => "5000.00",
        "MontoTotal" => "50000.00",
        "SubTotal" => "50000.00",
        "Codigo" => "01",
        "Tarifa" => "13",
        "Monto" => "6500.00",
        "MontoTotalLinea" => "56500.00"
    ],
    [
        "NumeroLinea" => "2",
        "Cantidad" => "5.00",
        "UnidadMedida" => "Unid",
        "Detalle" => "Producto gravado con IVA 4%",
        "PrecioUnitario" => "3000.00",
        "MontoTotal" => "15000.00",
        "SubTotal" => "15000.00",
        "Codigo" => "01",
        "Tarifa" => "4",
        "Monto" => "600.00",
        "MontoTotalLinea" => "15600.00"
    ],
    [
        "NumeroLinea" => "3",
        "Cantidad" => "2.00",
        "UnidadMedida" => "Kg",
        "Detalle" => "Producto exento de IVA",
        "PrecioUnitario" => "8000.00",
        "MontoTotal" => "16000.00",
        "SubTotal" => "16000.00",
        "Codigo" => "01",
        "Tarifa" => "0",
        "Monto" => "0.00",
        "MontoTotalLinea" => "16000.00"
    ],
    [
        "NumeroLinea" => "4",
        "Cantidad" => "1.00",
        "UnidadMedida" => "Sp",
        "Detalle" => "Servicio profesional",
        "PrecioUnitario" => "100000.00",
        "MontoTotal" => "100000.00",
        "SubTotal" => "100000.00",
        "Codigo" => "01",
        "Tarifa" => "13",
        "Monto" => "13000.00",
        "MontoTotalLinea" => "113000.00"
    ]
];

$data +=[
    // Datos del receptor
    'RECEPTOR_NOMBRE' => 'Cliente Importante S.A.',
    'RECEPTOR_NUMERO' => '3101360759',
    
    // Líneas de detalle
    'LINEAS' => json_encode($lineas),
    
    // Totales
    'SUBTOTAL' => 181000.00,
    'IV' => 20100.00,
    'TOTALIVI' => 201100.00,
    
    // Condiciones comerciales
    'CONDICIONVENTA' => '02',  // Crédito
    'PLAZOCREDITO' => '30',    // 30 días
    'MEDIOPAGO' => '04',       // Transferencia
    'CODIGOMONEDA' => 'CRC',

];

// Ejecutar petición
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

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

// Mostrar respuesta
echo "================================================================n";
echo "EJEMPLO 2: Factura Formato Carta - Múltiples Líneas - Créditon";
echo "================================================================n";
echo "HTTP Code: " . $http_code . "n";
echo "Respuesta: " . $response . "n";

// Si la respuesta es una clave de 50 caracteres, fue exitoso
if (strlen($response) == 50) {
    echo "n✓ FACTURA TIMBRADA EXITOSAMENTEn";
    echo "Clave: " . $response . "n";
    echo "nResumen de líneas:n";
    echo "- Línea 1: IVA 13%n";
    echo "- Línea 2: IVA 4%n";
    echo "- Línea 3: Exento (IVA 0%)n";
    echo "- Línea 4: IVA 13%n";
} else {
    echo "n✗ ERROR EN EL TIMBRAJEn";
}
?>

<?php
// Para que se vea en el navegador formateado el texto
header("Content-Type: text/plain; charset=UTF-8");

/**
 * Ejemplo 3: Factura con Descuentos
 * FACTURATica.com API
 */

$api_url = 'https://SU-DOMINIO-PANEL/_api.php';

$data = [
    'ACTION' => 'TIMBRAR_FACTURA',
    'CORREO' => 'correo@licencia.com',
    'API_KEY' => '8YQ...',
    'IDENTIFICACION' => '101110111',
    
];

/********************************************************************************
 * BLOQUE DE PRUEBAS                                                            *
 * Este bloque se utiliza para cargar datos de prueba durante el desarrollo.    *
 * Puede eliminarse sin problema alguno                                         *
 ********************************************************************************/
if (file_exists('datos_prueba.php')) {
    require_once 'datos_prueba.php';
}
/********************************************************************************
 * FIN DEL BLOQUE DE PRUEBAS                                                    *
 ********************************************************************************/

// Construir líneas de detalle con descuentos
$lineas = [
    [
        "NumeroLinea" => "1",
        "Cantidad" => "5.00",
        "UnidadMedida" => "Unid",
        "Detalle" => "Mouse inalámbrico",
        "PrecioUnitario" => "15000.00",
        "MontoTotal" => "75000.00",
        "MontoDescuento" => "7500.00",  // 10% descuento
        "NaturalezaDescuento" => "Descuento por volumen",
        "SubTotal" => "67500.00",
        "Codigo" => "01",
        "Cabys" => "4321100000000",
        "Tarifa" => "13",
        "Monto" => "8775.00",
        "MontoTotalLinea" => "76275.00"
    ],
    [
        "NumeroLinea" => "2",
        "Cantidad" => "3.00",
        "UnidadMedida" => "Unid",
        "Detalle" => "Teclado mecánico",
        "PrecioUnitario" => "45000.00",
        "MontoTotal" => "135000.00",
        "MontoDescuento" => "20250.00",  // 15% descuento
        "NaturalezaDescuento" => "Promoción especial",
        "SubTotal" => "114750.00",
        "Codigo" => "01",
        "Cabys" => "4321100000000",
        "Tarifa" => "13",
        "Monto" => "14917.50",
        "MontoTotalLinea" => "129667.50"
    ]
];

$data += [    // Datos del receptor
    'RECEPTOR_NOMBRE' => 'Comprador Final',
    'RECEPTOR_NUMERO' => '3101360759',
    'RECEPTOR_CORREOELECTRONICO' => '',
    'RECEPTOR_NUMTELEFONO' => '70007000',
    
    // Líneas de detalle
    'LINEAS' => json_encode($lineas),
    
    // Totales
    'TOTALDESCUENTOS' => 27750.00,  // Total de descuentos
    'SUBTOTAL' => 182250.00,        // Subtotal después de descuentos
    'IV' => 23692.50,
    'TOTALIVI' => 205942.50,
    
    // Condiciones comerciales
    'CONDICIONVENTA' => '01',      // Contado
    'MEDIOPAGO' => '02',           // Tarjeta
    'CODIGOMONEDA' => 'CRC',
    'OBSERVACIONES' => 'Descuentos aplicados por promoción Black Friday'
];

// Ejecutar petición
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

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

// Mostrar respuesta
echo "==============================================n";
echo "EJEMPLO 3: Factura con Descuentosn";
echo "==============================================n";
echo "HTTP Code: " . $http_code . "n";
echo "Respuesta: " . $response . "n";

// Si la respuesta es una clave de 50 caracteres, fue exitoso
if (strlen($response) == 50) {
    echo "n✓ FACTURA TIMBRADA EXITOSAMENTEn";
    echo "Clave: " . $response . "n";
    echo "nResumen de descuentos:n";
    echo "- Mouse inalámbrico: 10% descuento (₡7,500)n";
    echo "- Teclado mecánico: 15% descuento (₡20,250)n";
    echo "- Total descuentos: ₡27,750n";
    echo "- Total factura: ₡205,942.50n";
} else {
    echo "n✗ ERROR EN EL TIMBRAJEn";
}
?>

<?php
// Para que se vea en el navegador formateado el texto
header("Content-Type: text/plain; charset=UTF-8");
/**
 * Ejemplo 4: Factura con IVA Devuelto
 * FACTURATica.com API
 * 
 * IVA Devuelto aplica a:
 * - Servicios médicos privados
 * - Tarifa del 4%
 * - Pago con tarjeta
 */

$api_url = 'https://SU-DOMINIO-PANEL/_api.php';

$data = [
    'ACTION' => 'TIMBRAR_FACTURA',
    'CORREO' => 'correo@licencia.com',
    'API_KEY' => '8YQ...',
    'IDENTIFICACION' => '101110111',
    
    // Datos del receptor (paciente)
    'RECEPTOR_NUMERO' => '3101360759',
 
];

/********************************************************************************
 * BLOQUE DE PRUEBAS                                                            *
 * Este bloque se utiliza para cargar datos de prueba durante el desarrollo.    *
 * Puede eliminarse sin problema alguno                                         *
 ********************************************************************************/
if (file_exists('datos_prueba.php')) {
    require_once 'datos_prueba.php';
}
/********************************************************************************
 * FIN DEL BLOQUE DE PRUEBAS                                                    *
 ********************************************************************************/

// Construir líneas de detalle con servicios médicos
$lineas = [
    [
        "NumeroLinea" => "1",
        "Cantidad" => "1.00",
        "UnidadMedida" => "Sp",
        "Detalle" => "Consulta médica especializada",
        "PrecioUnitario" => "85000.00",
        "MontoTotal" => "85000.00",
        "SubTotal" => "85000.00",
        "Codigo" => "01",
        "Tarifa" => "4",  // Tarifa especial servicios médicos
        "Monto" => "3400.00",
        "MontoTotalLinea" => "88400.00",
        "ImpuestoNeto" => "-3400.00"  // IVA Devuelto (negativo)
    ],
    [
        "NumeroLinea" => "2",
        "Cantidad" => "1.00",
        "UnidadMedida" => "Sp",
        "Detalle" => "Exámenes de laboratorio",
        "PrecioUnitario" => "125000.00",
        "MontoTotal" => "125000.00",
        "SubTotal" => "125000.00",
        "Codigo" => "01",
        "Tarifa" => "4",  // Tarifa especial servicios médicos
        "Monto" => "5000.00",
        "MontoTotalLinea" => "130000.00",
        "ImpuestoNeto" => "-5000.00"  // IVA Devuelto (negativo)
    ],
    [
        "NumeroLinea" => "3",
        "Cantidad" => "1.00",
        "UnidadMedida" => "Sp",
        "Detalle" => "Radiografía digital",
        "PrecioUnitario" => "45000.00",
        "MontoTotal" => "45000.00",
        "SubTotal" => "45000.00",
        "Codigo" => "01",
        "Tarifa" => "4",  // Tarifa especial servicios médicos
        "Monto" => "1800.00",
        "MontoTotalLinea" => "46800.00",
        "ImpuestoNeto" => "-1800.00"  // IVA Devuelto (negativo)
    ],
    [
        "NumeroLinea" => "4",
        "Cantidad" => "1.00",
        "UnidadMedida" => "Unid",
        "Detalle" => "Medicamentos recetados",
        "PrecioUnitario" => "35000.00",
        "MontoTotal" => "35000.00",
        "SubTotal" => "35000.00",
        "Codigo" => "01",
        "Tarifa" => "0",  // Medicamentos están exentos
        "Monto" => "0.00",
        "MontoTotalLinea" => "35000.00"
    ]
];

$data += [
    // Líneas de detalle
    'LINEAS' => json_encode($lineas),
    
    // Totales con IVA devuelto
    'SUBTOTAL' => 290000.00,        // Subtotal de todos los servicios
    'TOTALEXENTO' => 35000.00,       // Medicamentos exentos
    'TOTALMERCANCIASGRAVADAS' => 255000.00,  // Servicios médicos gravados
    'IV' => 0.00,                    // IVA neto es 0 (todo devuelto)
    'TOTALIVI' => 290000.00,         // Total final (sin IVA por devolución)
    'TotalIVADevuelto' => 10200.00,  // Total IVA devuelto (3400+5000+1800)
    
    // Condiciones comerciales
    'CONDICIONVENTA' => '01',        // Contado
    'MEDIOPAGO' => '02',             // TARJETA (requisito para IVA devuelto)
    'CODIGOMONEDA' => 'CRC',
    'OBSERVACIONES' => 'IVA devuelto aplicado según normativa para servicios médicos pagados con tarjeta'
];


// Ejecutar petición
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

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

// Mostrar respuesta
echo "==============================================n";
echo "EJEMPLO 4: Factura con IVA Devuelton";
echo "       (Servicios Médicos Privados)n";
echo "==============================================n";
echo "HTTP Code: " . $http_code . "n";
echo "Respuesta: " . $response . "n";

// Si la respuesta es una clave de 50 caracteres, fue exitoso
if (strlen($response) == 50) {
    echo "n✓ FACTURA TIMBRADA EXITOSAMENTEn";
    echo "Clave: " . $response . "n";
    echo "nResumen de IVA Devuelto:n";
    echo "╔═══════════════════════════════════════════════╗n";
    echo "║ SERVICIOS MÉDICOS (Tarifa 4% - IVA Devuelto)  ║n";
    echo "╠═══════════════════════════════════════════════╣n";
    echo "║ Consulta médica:     ₡85,000 (IVA: -₡3,400)   ║n";
    echo "║ Exámenes lab:       ₡125,000 (IVA: -₡5,000)   ║n";
    echo "║ Radiografía:         ₡45,000 (IVA: -₡1,800)   ║n";
    echo "║ Medicamentos:        ₡35,000 (Exento)         ║n";
    echo "╠═══════════════════════════════════════════════╣n";
    echo "║ Subtotal:           ₡290,000                  ║n";
    echo "║ IVA Devuelto Total:  ₡10,200                  ║n";
    echo "║ TOTAL A PAGAR:      ₡290,000                  ║n";
    echo "║ Medio de Pago:      TARJETA (requisito)       ║n";
    echo "╚═══════════════════════════════════════════════╝n";
    echo "nNota: El IVA devuelto aplica únicamente a serviciosn";
    echo "médicos privados con tarifa del 4% pagados con tarjeta.n";
} else {
    echo "n✗ ERROR EN EL TIMBRAJEn";
}
?>

<?php
// Para que se vea en el navegador formateado el texto
header("Content-Type: text/plain; charset=UTF-8");

/**
 * Ejemplo 5: Tiquete Electrónico Simple
 * FACTURATica.com API
 * Para ventas a cliente general sin datos del receptor
 */

$api_url = 'https://SU-DOMINIO-PANEL/_api.php';

$data = [
    'ACTION' => 'TIMBRAR_TIQUETE',
    'CORREO' => 'correo@licencia.com',
    'API_KEY' => '8YQ...',
    'IDENTIFICACION' => '101110111',
];

/********************************************************************************
 * BLOQUE DE PRUEBAS                                                            *
 * Este bloque se utiliza para cargar datos de prueba durante el desarrollo.    *
 * Puede eliminarse sin problema alguno                                         *
 ********************************************************************************/
if (file_exists('datos_prueba.php')) {
    require_once 'datos_prueba.php';
}
/********************************************************************************
 * FIN DEL BLOQUE DE PRUEBAS                                                    *
 ********************************************************************************/

// Construir línea simple para tiquete
$lineas = [
    [
        "NumeroLinea" => "1",
        "Cantidad" => "1",
        "UnidadMedida" => "Unid",
        "Detalle" => "Venta de productos varios",
        "PrecioUnitario" => "10000.00",
        "MontoTotal" => "10000.00",
        "SubTotal" => "10000.00",
        "Tarifa" => "13",
        "Monto" => "1300.00",
        "MontoTotalLinea" => "11300.00"
    ]
];

$data += [
    // Líneas de detalle
    'LINEAS' => json_encode($lineas),
    
    // Totales
    'SUBTOTAL' => 10000.00,
    'IV' => 1300.00,
    'TOTALIVI' => 11300.00,

];

// Ejecutar petición
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

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

// Mostrar respuesta
echo "==============================================n";
echo "EJEMPLO 5: Tiquete Electrónico Simplen";
echo "==============================================n";
echo "HTTP Code: " . $http_code . "n";
echo "Respuesta: " . $response . "n";

// Si la respuesta es una clave de 50 caracteres, fue exitoso
if (strlen($response) == 50) {
    echo "n✓ TIQUETE TIMBRADO EXITOSAMENTEn";
    echo "Clave: " . $response . "n";
    echo "nCaracterísticas del tiquete:n";
    echo "- Cliente: General (sin datos)n";
    echo "- Pago: Efectivon";
    echo "- Total: ₡11,300n";
    echo "- Formato: Pequeño (tiquete)n";
} else {
    echo "n✗ ERROR EN EL TIMBRAJEn";
}
?>

<?php
// Para que se vea en el navegador formateado el texto
header("Content-Type: text/plain; charset=UTF-8");

/**
 * Ejemplo 9: Nota de Crédito Electrónica - Anulación Total
 * FACTURATica.com API
 * 
 * Anula completamente una factura previamente emitida
 */

$api_url = 'https://SU-DOMINIO-PANEL/_api.php';

// IMPORTANTE: Reemplaza esta clave con una clave real de un documento
// que haya timbrado previamente y que desee afectar
$clave_documento = '506...';


$data = [
    'ACTION' => 'TIMBRAR_CREDITO',
    'CORREO' => 'correo@licencia.com',
    'API_KEY' => '8YQ...',
    'IDENTIFICACION' => '101110111',
    
    // Datos del receptor (mismo de la factura original)
    'RECEPTOR_NUMERO' => '3101360759',
    
    // Condiciones comerciales
    'CONDICIONVENTA' => '01',  // Contado
    'MEDIOPAGO' => '04',       // Transferencia
    'CODIGOMONEDA' => 'CRC',

];

/********************************************************************************
 * BLOQUE DE PRUEBAS                                                            *
 * Este bloque se utiliza para cargar datos de prueba durante el desarrollo.    *
 * Puede eliminarse sin problema alguno                                         *
 ********************************************************************************/
if (file_exists('datos_prueba.php')) {
    require_once 'datos_prueba.php';
}
/********************************************************************************
 * FIN DEL BLOQUE DE PRUEBAS                                                    *
 ********************************************************************************/

// Construir líneas de detalle 
$lineas = [
    [
        "NumeroLinea" => "1",
        "Cantidad" => "10.00",
        "UnidadMedida" => "Unid",
        "Detalle" => "Producto gravado con IVA 13%",
        "PrecioUnitario" => "5000.00",
        "MontoTotal" => "50000.00",
        "SubTotal" => "50000.00",
        "Codigo" => "01",
        "Tarifa" => "13",
        "Monto" => "6500.00",
        "MontoTotalLinea" => "56500.00"
    ]
];


// Añadimos líneas a los datos
$data +=[
    // Líneas de detalle
    'LINEAS' => json_encode($lineas),
    
    // Totales (mismos de la factura original)
    'SUBTOTAL' => 50000.00,
    'IV' => 6500.00,
    'TOTALIVI' => 56500.00,

    // === INFORMACIÓN DE REFERENCIA (NOMBRES CORRECTOS) ===
    'InformacionReferencia_TIPODOCREFERENCIA' => '01',  // 01 = Factura Electrónica
    'InformacionReferencia_Numero' => $clave_documento,  // Clave de 50 dígitos
    'InformacionReferencia_Fecha' => '01/10/2024',  // Formato: dd/mm/yyyy
    'InformacionReferencia_CODIGOREFERENCIA' => '01',  // 01 = Anula Documento
    'InformacionReferencia_Razon' => 'Anulación total de la factura por error en emisión'
];

// Ejecutar petición
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

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

// Mostrar respuesta
echo "==============================================n";
echo "EJEMPLO 9: Nota de Créditon";
echo "==============================================n";
echo "HTTP Code: " . $http_code . "n";
echo "Respuesta: " . $response . "n";

// Si la respuesta es una clave de 50 caracteres, fue exitoso
if (strlen($response) == 50) {
    echo "n✓ NOTA DE CRÉDITO TIMBRADA EXITOSAMENTEn";
    echo "Clave NC: " . $response . "n";
    echo "nCaracterísticas:n";
    echo "- Referencia: Factura " . substr($data['InformacionReferencia_Numero'], -10) . "n";
    echo "- Monto anulado: " . $data['TOTALIVI'] . "n";
} else {
    echo "n✗ ERROR EN EL TIMBRAJEn";
}

<?php
// Para que se vea en el navegador formateado el texto
header("Content-Type: text/plain; charset=UTF-8");

/**
 * Ejemplo 10: Nota de Débito Electrónica - Corrección de Monto
 * FACTURATica.com API
 * 
 * Aumenta el monto de una factura previamente emitida
 * (Por ejemplo, por cobro adicional o cargo olvidado)
 */

$api_url = 'https://SU-DOMINIO-PANEL/_api.php';

// IMPORTANTE: Reemplaza esta clave con una clave real de un documento
// que haya timbrado previamente y que desee afectar
$clave_documento = '506...';


$data = [
    'ACTION' => 'TIMBRAR_DEBITO',
    'CORREO' => 'correo@licencia.com',
    'API_KEY' => '8YQ...',
    'IDENTIFICACION' => '101110111',
    
    // Datos del receptor (mismo de la factura original)
    'RECEPTOR_NUMERO' => '3101360759',

    
    // Condiciones comerciales
    'CONDICIONVENTA' => '01',  // Contado
    'MEDIOPAGO' => '04',       // Transferencia
    'CODIGOMONEDA' => 'CRC',
];


/********************************************************************************
 * BLOQUE DE PRUEBAS                                                            *
 * Este bloque se utiliza para cargar datos de prueba durante el desarrollo.    *
 * Puede eliminarse sin problema alguno                                         *
 ********************************************************************************/
if (file_exists('datos_prueba.php')) {
    require_once 'datos_prueba.php';
}
/********************************************************************************
 * FIN DEL BLOQUE DE PRUEBAS                                                    *
 ********************************************************************************/

// Construir líneas de detalle con el MONTO ADICIONAL a cobrar
$lineas = [
    [
        "NumeroLinea" => "1",
        "Cantidad" => "1.00",
        "UnidadMedida" => "Sp",
        "Detalle" => "Cargo adicional por servicio de entrega urgente",
        "PrecioUnitario" => "15000.00",
        "MontoTotal" => "15000.00",
        "SubTotal" => "15000.00",
        "Codigo" => "01",
        "Tarifa" => "13",
        "Monto" => "1950.00",
        "MontoTotalLinea" => "16950.00"
    ]
];

// Añadimos líneas a los datos
$data +=[
    // Líneas de detalle
    'LINEAS' => json_encode($lineas),
    
    // Totales (solo del monto adicional a cobrar)
    'SUBTOTAL' => 15000.00,
    'IV' => 1950.00,
    'TOTALIVI' => 16950.00,

        // === INFORMACIÓN DE REFERENCIA (NOMBRES CORRECTOS) ===
    'InformacionReferencia_TIPODOCREFERENCIA' => '01',  // 01 = Factura Electrónica
    'InformacionReferencia_Numero' => $clave_documento,  // Clave de 50 dígitos
    'InformacionReferencia_Fecha' => '01/10/2024',  // Formato: dd/mm/yyyy
    'InformacionReferencia_CODIGOREFERENCIA' => '01',  // 01 = Anula Documento
    'InformacionReferencia_Razon' => 'Anulación total de la factura por error en emisión'
];


// Ejecutar petición
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

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

// Mostrar respuesta
echo "==============================================n";
echo "EJEMPLO 10: Nota de Débito - Corrección Monton";
echo "==============================================n";
echo "HTTP Code: " . $http_code . "n";
echo "Respuesta: " . $response . "n";

// Si la respuesta es una clave de 50 caracteres, fue exitoso
if (strlen($response) == 50) {
    echo "n✓ NOTA DE DÉBITO TIMBRADA EXITOSAMENTEn";
    echo "Clave ND: " . $response . "n";
    echo "nCaracterísticas:n";
    echo "- Tipo: Corrección de monto (incremento)n";
    echo "- Referencia: Factura " . substr($data['InformacionReferencia_Numero'], -10) . "n";
    echo "- Monto adicional: " . $data['TOTALIVI'] . "n";
} else {
    echo "n✗ ERROR EN EL TIMBRAJEn";
}

<?php
// Para que se vea en el navegador formateado el texto
header("Content-Type: text/plain; charset=UTF-8");

/**
 * Ejemplo 11: Factura Electrónica de Compra (FEC) - CASO AIRBNB
 * FACTURATica.com API
 *
 * ┌─────────────────────────────────────────────────────────────────────────┐
 * │ ¿Qué es este caso?                                                      │
 * ├─────────────────────────────────────────────────────────────────────────┤
 * │ Airbnb cobra comisiones a sus anfitriones costarricenses. Aunque       │
 * │ Airbnb opera bajo la cédula jurídica 3-130-195480 (Costa Rica), para   │
 * │ efectos tributarios califica como "Proveedor No Domiciliado", por lo   │
 * │ que la Información de Referencia debe usar:                            │
 * │   - TipoDocIR  = 16  (Comprobante de Proveedor No Domiciliado)         │
 * │   - Codigo     = 11  (Proveedor No Domiciliado)                        │
 * └─────────────────────────────────────────────────────────────────────────┘
 *
 * En FEC, los campos RECEPTOR_* contienen los datos del PROVEEDOR (Airbnb).
 * El sistema intercambia Emisor/Receptor al generar el XML: la licencia
 * (el anfitrión costarricense) queda como Receptor, y Airbnb como Emisor.
 *
 * La Información de Referencia es OBLIGATORIA en FEC.
 */

$api_url = 'https://SU-DOMINIO-PANEL/_api.php';

$data = [
    'ACTION'         => 'TIMBRAR_COMPRA',
    'CORREO'         => 'correo@licencia.com',
    'API_KEY'        => '8YQ...',
    'IDENTIFICACION' => '101110111',   // Anfitrión (licencia compradora)
];

/********************************************************************************
 * BLOQUE DE PRUEBAS                                                            *
 * Este bloque se utiliza para cargar datos de prueba durante el desarrollo.    *
 * Puede eliminarse sin problema alguno                                         *
 ********************************************************************************/
if (file_exists('datos_prueba.php')) {
    require_once 'datos_prueba.php';
}
/********************************************************************************
 * FIN DEL BLOQUE DE PRUEBAS                                                    *
 ********************************************************************************/

// Línea de detalle: comisión cobrada por Airbnb en una reservación
$lineas = [
    [
        "NumeroLinea"     => "1",
        "Cantidad"        => "1.00",
        "UnidadMedida"    => "Sp",                            // Sp = Servicios Profesionales
        "Detalle"         => "Comisión de servicio Airbnb - Reservación HMXY1234",
        "PrecioUnitario"  => "15000.00",
        "MontoTotal"      => "15000.00",
        "SubTotal"        => "15000.00",
        "Codigo"          => "01",
        "Tarifa"          => "13",
        "Monto"           => "1950.00",
        "MontoTotalLinea" => "16950.00"
    ]
];

$data += [
    // =========================================================================
    // DATOS DEL PROVEEDOR: AIRBNB (viajan como RECEPTOR_* y se intercambian
    // automáticamente a Emisor al construir el XML de la FEC)
    // =========================================================================
    'RECEPTOR_NOMBRE'            => 'Airbnb Payments, Inc.',
    'RECEPTOR_NUMERO'            => '3130195480',             // Cédula jurídica reconocida de Airbnb en CR
    'RECEPTOR_CORREOELECTRONICO' => 'payments@airbnb.com',
    'RECEPTOR_NUMTELEFONO'       => '00000000',

    // Líneas de detalle
    'LINEAS'                     => json_encode($lineas),

    // Totales
    'SUBTOTAL'                   => 15000.00,
    'TOTALEXENTO'                => 0.00,
    'TOTALMERCANCIASGRAVADAS'    => 15000.00,
    'TOTALDESCUENTOS'            => 0.00,
    'IV'                         =>  1950.00,
    'TOTALIVI'                   => 16950.00,

    // Condiciones comerciales
    'CONDICIONVENTA'             => '01',   // Contado
    'MEDIOPAGO'                  => '04',   // Transferencia
    'CODIGOMONEDA'               => 'CRC',

    // =========================================================================
    // INFORMACIÓN DE REFERENCIA (OBLIGATORIA para FEC)
    // Caso Airbnb: Proveedor No Domiciliado
    // =========================================================================
    'InformacionReferencia_TIPODOCREFERENCIA' => '16',        // Comprobante de Proveedor No Domiciliado
    'InformacionReferencia_CODIGOREFERENCIA'  => '11',        // Proveedor No Domiciliado
    'InformacionReferencia_Numero'            => 'HMXY1234-RECEIPT',  // Número del recibo/invoice de Airbnb
    'InformacionReferencia_Fecha'             => date('d/m/Y'),       // Formato d/m/Y
    'InformacionReferencia_Razon'             => 'Comisión por servicios de Airbnb',
];

// Ejecutar petición
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

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

// Mostrar respuesta
echo "==============================================n";
echo "EJEMPLO 11: FEC - Airbnb (Proveedor No Domiciliado)n";
echo "==============================================n";
echo "HTTP Code: " . $http_code . "n";
echo "Respuesta: " . $response . "n";

// Si la respuesta es una clave de 50 caracteres, fue exitoso
if (strlen($response) == 50) {
    echo "n✓ FEC TIMBRADA EXITOSAMENTEn";
    echo "Clave: " . $response . "n";
} else {
    echo "n✗ ERROR EN EL TIMBRAJEn";
}
?>

<?php
// Para que se vea en el navegador formateado el texto
header("Content-Type: text/plain; charset=UTF-8");

/**
 * Ejemplo 12: Factura Electrónica de Compra (FEC) - CASO PROVEEDOR EXTRANJERO
 * FACTURATica.com API
 *
 * ┌─────────────────────────────────────────────────────────────────────────┐
 * │ ¿Qué es este caso?                                                      │
 * ├─────────────────────────────────────────────────────────────────────────┤
 * │ Compra de servicios digitales a un proveedor no domiciliado en Costa   │
 * │ Rica (ej: Amazon Web Services, Google Cloud, Microsoft Azure, OpenAI,  │
 * │ Anthropic, etc.). El proveedor NO tiene cédula costarricense, por lo   │
 * │ que su identificación contiene letras o supera los 12 caracteres.     │
 * │                                                                         │
 * │ El sistema detecta automáticamente proveedor extranjero por la         │
 * │ presencia de letras en RECEPTOR_NUMERO (o longitud > 12) y:            │
 * │   - Asigna TipoIdentificacion = 05 (Extranjero)                        │
 * │   - Usa RECEPTOR_OTRASSENAS_EXT como dirección extranjera del Emisor   │
 * │   - Omite la Ubicación nacional (Provincia/Cantón/Distrito)            │
 * │                                                                         │
 * │ La Información de Referencia debe usar:                                │
 * │   - TipoDocIR  = 16  (Comprobante de Proveedor No Domiciliado)         │
 * │   - Codigo     = 11  (Proveedor No Domiciliado)                        │
 * └─────────────────────────────────────────────────────────────────────────┘
 *
 * En FEC, los campos RECEPTOR_* contienen los datos del PROVEEDOR (AWS).
 * Al construir el XML el sistema intercambia Emisor/Receptor: la licencia
 * costarricense queda como Receptor y AWS como Emisor extranjero.
 *
 * La Información de Referencia es OBLIGATORIA en FEC.
 */

$api_url = 'https://SU-DOMINIO-PANEL/_api.php';

$data = [
    'ACTION'         => 'TIMBRAR_COMPRA',
    'CORREO'         => 'correo@licencia.com',
    'API_KEY'        => '8YQ...',
    'IDENTIFICACION' => '101110111',   // Empresa costarricense (licencia compradora)
];

/********************************************************************************
 * BLOQUE DE PRUEBAS                                                            *
 * Este bloque se utiliza para cargar datos de prueba durante el desarrollo.    *
 * Puede eliminarse sin problema alguno                                         *
 ********************************************************************************/
if (file_exists('datos_prueba.php')) {
    require_once 'datos_prueba.php';
}
/********************************************************************************
 * FIN DEL BLOQUE DE PRUEBAS                                                    *
 ********************************************************************************/

// Línea de detalle: servicios de AWS (convertidos a CRC en este ejemplo)
$lineas = [
    [
        "NumeroLinea"     => "1",
        "Cantidad"        => "1.00",
        "UnidadMedida"    => "Sp",                            // Sp = Servicios Profesionales
        "Detalle"         => "Amazon Web Services - EC2, S3 y CloudFront (Invoice INV-2026-04-001)",
        "PrecioUnitario"  => "250000.00",
        "MontoTotal"      => "250000.00",
        "SubTotal"        => "250000.00",
        "Codigo"          => "01",
        "Tarifa"          => "13",
        "Monto"           => "32500.00",
        "MontoTotalLinea" => "282500.00"
    ]
];

$data += [
    // =========================================================================
    // DATOS DEL PROVEEDOR EXTRANJERO: AWS (viajan como RECEPTOR_* y se
    // intercambian automáticamente a Emisor al construir el XML de la FEC).
    // El sistema detecta extranjero por las letras en RECEPTOR_NUMERO.
    // =========================================================================
    'RECEPTOR_NOMBRE'            => 'Amazon Web Services EMEA SARL',
    'RECEPTOR_NUMERO'            => 'LU26375245',                          // VAT europeo (contiene letras)
    'RECEPTOR_CORREOELECTRONICO' => 'aws-receivables@amazon.com',
    'RECEPTOR_NUMTELEFONO'       => '00000000',

    // Dirección extranjera del proveedor (se coloca en <Emisor><OtrasSenasExtranjero>)
    'RECEPTOR_OTRASSENAS_EXT'    => '38 Avenue John F. Kennedy, L-1855 Luxembourg',

    // Líneas de detalle
    'LINEAS'                     => json_encode($lineas),

    // Totales
    'SUBTOTAL'                   => 250000.00,
    'TOTALEXENTO'                => 0.00,
    'TOTALMERCANCIASGRAVADAS'    => 250000.00,
    'TOTALDESCUENTOS'            => 0.00,
    'IV'                         =>  32500.00,
    'TOTALIVI'                   => 282500.00,

    // Condiciones comerciales
    'CONDICIONVENTA'             => '01',   // Contado
    'MEDIOPAGO'                  => '04',   // Transferencia
    'CODIGOMONEDA'               => 'CRC',  // Si la factura real está en USD, convierta previamente

    // =========================================================================
    // INFORMACIÓN DE REFERENCIA (OBLIGATORIA para FEC)
    // Caso proveedor extranjero: Comprobante de Proveedor No Domiciliado
    // =========================================================================
    'InformacionReferencia_TIPODOCREFERENCIA' => '16',        // Comprobante de Proveedor No Domiciliado
    'InformacionReferencia_CODIGOREFERENCIA'  => '11',        // Proveedor No Domiciliado
    'InformacionReferencia_Numero'            => 'INV-2026-04-001',   // Invoice number del proveedor
    'InformacionReferencia_Fecha'             => date('d/m/Y'),       // Formato d/m/Y
    'InformacionReferencia_Razon'             => 'Servicios digitales - Proveedor no domiciliado',
];

// Ejecutar petición
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

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

// Mostrar respuesta
echo "==============================================n";
echo "EJEMPLO 12: FEC - AWS (Proveedor Extranjero)n";
echo "==============================================n";
echo "HTTP Code: " . $http_code . "n";
echo "Respuesta: " . $response . "n";

// Si la respuesta es una clave de 50 caracteres, fue exitoso
if (strlen($response) == 50) {
    echo "n✓ FEC TIMBRADA EXITOSAMENTEn";
    echo "Clave: " . $response . "n";
} else {
    echo "n✗ ERROR EN EL TIMBRAJEn";
}
?>

<?php
// Para que se vea en el navegador formateado el texto
header("Content-Type: text/plain; charset=UTF-8");

/**
 * Ejemplo 13: Factura Electrónica de Exportación (FEE)
 * FACTURATica.com API
 *
 * ┌─────────────────────────────────────────────────────────────────────────┐
 * │ ¿Qué es este caso?                                                      │
 * ├─────────────────────────────────────────────────────────────────────────┤
 * │ Venta a un cliente extranjero (fuera de Costa Rica). Las exportaciones │
 * │ son operaciones EXENTAS de IVA, normalmente facturadas en USD u otra   │
 * │ moneda extranjera.                                                      │
 * │                                                                         │
 * │ Características distintivas:                                            │
 * │   - ACTION         = TIMBRAR_FACTURA_EXPORTACION                        │
 * │   - CONDICIONVENTA = 01 contado (Hacienda v4.4 ya NO acepta el código '12')│
 * │   - IV             = 0   (sin IVA, exportación exenta)                  │
 * │   - Tarifa de cada línea = 0                                            │
 * │   - CODIGOMONEDA   = USD (típico) + TIPO_DE_CAMBIO                      │
 * │   - RECEPTOR_NUMERO contiene letras → identificación tipo 05            │
 * │   - RECEPTOR_OTRASSENAS_EXT con la dirección extranjera                 │
 * └─────────────────────────────────────────────────────────────────────────┘
 */

$api_url = 'https://SU-DOMINIO-PANEL/_api.php';

$data = [
    'ACTION'         => 'TIMBRAR_FACTURA_EXPORTACION',
    'CORREO'         => 'correo@licencia.com',
    'API_KEY'        => '8YQ...',
    'IDENTIFICACION' => '101110111',
];

/********************************************************************************
 * BLOQUE DE PRUEBAS                                                            *
 * Este bloque se utiliza para cargar datos de prueba durante el desarrollo.    *
 * Puede eliminarse sin problema alguno                                         *
 ********************************************************************************/
if (file_exists('datos_prueba.php')) {
    require_once 'datos_prueba.php';
}
/********************************************************************************
 * FIN DEL BLOQUE DE PRUEBAS                                                    *
 ********************************************************************************/

// Línea de detalle: servicio de consultoría exportado a cliente en Estados Unidos
// Las exportaciones llevan tarifa 0 (exentas de IVA).
$lineas = [
    [
        "NumeroLinea"     => "1",
        "Cantidad"        => "1.00",
        "UnidadMedida"    => "Sp",                              // Servicios Profesionales
        "Detalle"         => "Consultoría tecnológica - Marzo 2026",
        "PrecioUnitario"  => "1500.00",                          // En USD
        "MontoTotal"      => "1500.00",
        "SubTotal"        => "1500.00",
        "Codigo"          => "01",
        "Tarifa"          => "0",                                // Exportación: exenta de IVA
        "Monto"           => "0.00",
        "MontoTotalLinea" => "1500.00"
    ],
    [
        "NumeroLinea"     => "2",
        "Cantidad"        => "10.00",
        "UnidadMedida"    => "h",                                // Horas
        "Detalle"         => "Soporte técnico remoto",
        "PrecioUnitario"  => "75.00",
        "MontoTotal"      => "750.00",
        "SubTotal"        => "750.00",
        "Codigo"          => "01",
        "Tarifa"          => "0",
        "Monto"           => "0.00",
        "MontoTotalLinea" => "750.00"
    ]
];

$data += [
    // =========================================================================
    // DATOS DEL RECEPTOR EXTRANJERO
    // El sistema detecta receptor extranjero por las letras en RECEPTOR_NUMERO
    // y le asigna tipoIdentificacion = 05.
    // =========================================================================
    'RECEPTOR_NOMBRE'            => 'Acme Corporation Inc.',
    'RECEPTOR_NUMERO'            => 'EIN-841234567',             // Tax ID estadounidense (con letras)
    'RECEPTOR_CORREOELECTRONICO' => 'accounts-payable@acme.com',
    'RECEPTOR_NUMTELEFONO'       => '00000000',

    // Dirección extranjera del cliente (se coloca en <Receptor><OtrasSenasExtranjero>)
    'RECEPTOR_OTRASSENAS_EXT'    => '350 Fifth Avenue, New York, NY 10118, USA',

    // Líneas de detalle
    'LINEAS'                     => json_encode($lineas),

    // Totales (sin IVA — exportación)
    'SUBTOTAL'                   => 2250.00,
    'IV'                         => 0.00,
    'TOTALIVI'                   => 2250.00,

    // Condiciones comerciales
    'CONDICIONVENTA'             => '01',         // Contado (Hacienda v4.4 ya no acepta '12')
    'MEDIOPAGO'                  => '04',         // Transferencia internacional
    'CODIGOMONEDA'               => 'USD',        // Dólar estadounidense
    'TIPO_DE_CAMBIO'             => '520.00',    // CRC por USD (referencial - el sistema toma del día si se omite)

    'OBSERVACIONES'              => 'Servicios profesionales prestados desde Costa Rica al exterior',
];

// Ejecutar petición
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

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

// Mostrar respuesta
echo "==============================================n";
echo "EJEMPLO 13: FEE - Factura de Exportación (USD)n";
echo "==============================================n";
echo "HTTP Code: " . $http_code . "n";
echo "Respuesta: " . $response . "n";

// Si la respuesta es una clave de 50 caracteres, fue exitoso
if (strlen($response) == 50) {
    echo "n✓ FACTURA DE EXPORTACIÓN TIMBRADA EXITOSAMENTEn";
    echo "Clave: " . $response . "n";
    echo "nCaracterísticas:n";
    echo "- Receptor: cliente extranjero (USA)n";
    echo "- Moneda: USDn";
    echo "- IVA: 0 (exportación exenta)n";
    echo "- Subtotal USD: $" . number_format($data['SUBTOTAL'], 2) . "n";
} else {
    echo "n✗ ERROR EN EL TIMBRAJEn";
}
?>

<?php
// Para que se vea en el navegador formateado el texto
header("Content-Type: text/plain; charset=UTF-8");

/**
 * Ejemplo 6: Anulación de Documento
 * FACTURATica.com API
 * 
 * IMPORTANTE: Para usar este ejemplo, primero debes tener una clave
 * de un documento previamente timbrado que desees anular.
 */


$api_url = 'https://SU-DOMINIO-PANEL/_api.php';

// IMPORTANTE: Reemplaza esta clave con una clave real de un documento
// que hayas timbrado previamente y que desees anular
$clave_documento = '506...';

$data = [
    'ACTION' => 'ANULAR',
    'CORREO' => 'correo@licencia.com',
    'API_KEY' => '8YQ...',
    'IDENTIFICACION' => '101110111',
    
];

/********************************************************************************
 * BLOQUE DE PRUEBAS                                                            *
 * Este bloque se utiliza para cargar datos de prueba durante el desarrollo.    *
 * Puede eliminarse sin problema alguno                                         *
 ********************************************************************************/
if (file_exists('datos_prueba.php')) {
    require_once 'datos_prueba.php';
}
/********************************************************************************
 * FIN DEL BLOQUE DE PRUEBAS                                                    *
 ********************************************************************************/

// Datos para la anulación

$data +=[
       'CLAVENUMERICA' => $clave_documento,
    'PORCENTAJE_ANULACION' => 100 // Parámetro opcional
];

echo "==============================================n";
echo "EJEMPLO 6: Anulación de Documenton";
echo "==============================================n";
echo "NOTA: Para probar este ejemplo, necesitas una claven";
echo "de un documento previamente timbrado y ACEPTADO.n";
echo "----------------------------------------------n";

// Validar longitud de la clave
if (strlen($clave_documento) == 50) {
    $clave_documento = $clave_documento;
} else {
    echo "Error: La clave debe tener exactamente 50 caracteres.n";
    echo "Longitud ingresada: " . strlen($clave_documento) . " caracteres.n";
    exit;
}



echo "nAnulando documento con clave:n" . $clave_documento . "nn";

// Ejecutar petición
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

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

// Mostrar respuesta
echo "HTTP Code: " . $http_code . "n";
echo "Respuesta: " . $response . "nn";

// Interpretar respuesta
if (strlen($response) == 50) {
    echo "✓ DOCUMENTO ANULADO EXITOSAMENTEn";
    echo "Clave de la nota de crédito: " . $response . "n";
} else {
    echo "✗ ERROR EN LA ANULACIÓNn";

    // Interpretar códigos de error comunes
    switch ($response) {
        case '-1':
            echo "Error: Parámetros faltantes o incorrectosn";
            break;
        case '-2':
            echo "Error: Fallo de conexión con la base de datosn";
            break;
        case '0':
            echo "Error: Credenciales rechazadasn";
            break;
        default:
            echo "Código de error: " . $response . "n";
    }
}

echo "n==============================================n";
echo "INSTRUCCIONES PARA PROBAR LA ANULACIÓN:n";
echo "==============================================n";
echo "1. Primero ejecuta uno de los ejemplos 1-5 para timbrar un documenton";
echo "2. Copia la clave de 50 caracteres que se generan";
echo "3. Ejecuta este script e ingresa esa clave cuando se soliciten";
echo "4. El documento será anulado en el sisteman";

<?php
// Para que se vea en el navegador formateado el texto
header("Content-Type: text/plain; charset=UTF-8");

/**
 * Ejemplo 7: Obtener nombre por identificación
 * FACTURATica.com API
 * 
 * IMPORTANTE: Solo se admiten cédulas físicas, jurídicas, dimex y nites de 9-12 digitos.
 */

$api_url = 'https://SU-DOMINIO-PANEL/_api.php';

// IMPORTANTE: Reemplaza este número por la que desee utilizar
$numero = '3101360759';

echo "=============================================================n";
echo "EJEMPLO 7: Obtener nombre por identificaciónn";
echo "=============================================================n";
echo "NOTA: Para probar este ejemplo, necesita un númeron";
echo "de identificación nacional, dimex o nite de 9-12 digitos.n";
echo "-------------------------------------------------------------n";


$data = [
    'ACTION' => 'NOMBRE',
    'CORREO' => 'correo@licencia.com',
    'API_KEY' => '8YQ...',
    'IDENTIFICACION' => '101110111',
];

/********************************************************************************
 * BLOQUE DE PRUEBAS                                                            *
 * Este bloque se utiliza para cargar datos de prueba durante el desarrollo.    *
 * Puede eliminarse sin problema alguno                                         *
 ********************************************************************************/
if (file_exists('datos_prueba.php')) {
    require_once 'datos_prueba.php';
}
/********************************************************************************
 * FIN DEL BLOQUE DE PRUEBAS                                                    *
 ********************************************************************************/

$data += [
    'NUMERO' => $numero
];

echo "nObteniendo nombre para la identificación número:n" . $numero . "nn";

// Ejecutar petición
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

$response_raw = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// Mostrar respuesta
echo "HTTP Code: " . $http_code . "n";
echo "Respuesta: " . $response_raw . "nn";

// Interpretar respuesta
$response = json_decode($response_raw, true);

if (isset($response['success']) && $response['success'] === true) {
    echo "✓ NOMBRE OBTENIDO EXITOSAMENTEnn";
    echo "Número consultado: " . $response['numero'] . "n";
    echo "Nombre: " . $response['nombre'] . "n";
} else {
    echo "✗ ERROR EN LA OBTENCIÓN DEL NOMBREnn";
    print_r($response_raw);
}

<?php
// Para que se vea en el navegador formateado el texto
header("Content-Type: text/plain; charset=UTF-8");

/**
 * Ejemplo 8: Consultar Estado de Documento
 * FACTURATica.com API
 * 
 * IMPORTANTE: Para usar este ejemplo, necesitas una clave de 50 caracteres
 * de un documento previamente timbrado.
 */

$api_url = 'https://SU-DOMINIO-PANEL/_api.php';

// IMPORTANTE: Reemplaza esta clave con una clave real de un documento
// que hayas timbrado previamente y del cual desees conocer el estado
$clave_documento = '506...';

echo "==============================================n";
echo "EJEMPLO 8: Consultar Estado de Documenton";
echo "==============================================n";
echo "Este ejemplo muestra cómo consultar el estadon";
echo "de un documento y obtener sus archivos.n";
echo "----------------------------------------------nn";

// Ejemplo 1: Solo consultar estado (sin archivos)
echo "═══════════════════════════════════════════════n";
echo "CONSULTA 1: Solo Estado (sin archivos)n";
echo "═══════════════════════════════════════════════n";

$data = [
    'ACTION' => 'ESTADO',
    'CORREO' => 'correo@licencia.com',
    'API_KEY' => '8YQ...',
    'IDENTIFICACION' => '101110111',
];

/********************************************************************************
 * BLOQUE DE PRUEBAS                                                            *
 * Este bloque se utiliza para cargar datos de prueba durante el desarrollo.    *
 * Puede eliminarse sin problema alguno                                         *
 ********************************************************************************/
if (file_exists('datos_prueba.php')) {
    require_once 'datos_prueba.php';
}
/********************************************************************************
 * FIN DEL BLOQUE DE PRUEBAS                                                    *
 ********************************************************************************/

// Validar longitud de la clave
if (strlen($clave_documento) != 50) {
    echo "⚠ ADVERTENCIA: La clave debe tener exactamente 50 caracteres.n";
    echo "Longitud actual: " . strlen($clave_documento) . " caracteres.n";
    echo "Por favor, verifica la clave del documento.n";
    exit;
}

$data += [
    'CLAVENUMERICA' => $clave_documento,
    'ADJUNTOS' => 0  // 0 = Solo estado
];

$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

$response_raw = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo "HTTP Code: " . $http_code . "n";
echo "Respuesta: " . $response_raw . "n";

$response = json_decode($response_raw, true);
if ($response && isset($response['ind-estado'])) {
    echo "n✓ Estado del documento: " . strtoupper($response['ind-estado']) . "n";
    if (isset($response['respuesta-xml'])) {
        echo "Mensaje: " . $response['respuesta-xml'] . "n";
    }
}

// Ejemplo 2: Estado + XML Firmado
echo "n═══════════════════════════════════════════════n";
echo "CONSULTA 2: Estado + XML Firmadon";
echo "═══════════════════════════════════════════════n";

$data['ADJUNTOS'] = 1;  // 1 = Estado + XML

$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

$response_raw = curl_exec($ch);
curl_close($ch);

$response = json_decode($response_raw, true);
if ($response && isset($response['FIRMADO'])) {
    echo "✓ XML Firmado incluido (Base64): ";
    echo substr($response['FIRMADO'], 0, 50) . "...n";
    echo "Longitud del XML en Base64: " . strlen($response['FIRMADO']) . " caracteresn";
    
    // Opcional: Guardar el XML decodificado
    // file_put_contents('documento.xml', base64_decode($response['FIRMADO']));
}

// Ejemplo 3: Estado + XML + Respuesta de Hacienda
echo "n═══════════════════════════════════════════════n";
echo "CONSULTA 3: Estado + XML + Respuesta Haciendan";
echo "═══════════════════════════════════════════════n";

$data['ADJUNTOS'] = 2;  // 2 = Estado + XML + Respuesta

$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

$response_raw = curl_exec($ch);
curl_close($ch);

$response = json_decode($response_raw, true);
if ($response) {
    if (isset($response['FIRMADO'])) {
        echo "✓ XML Firmado incluidon";
    }
    if (isset($response['RESPUESTA_XML'])) {
        echo "✓ XML de Respuesta de Hacienda incluidon";
        echo "Longitud respuesta Base64: " . strlen($response['RESPUESTA_XML']) . " caracteresn";
    }
}

// Ejemplo 4: Estado + XML + PDF + Respuesta
echo "n═══════════════════════════════════════════════n";
echo "CONSULTA 4: Todos los archivos (XML+PDF+Respuesta)n";
echo "═══════════════════════════════════════════════n";

$data['ADJUNTOS'] = 3;  // 3 = Todo

$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

$response_raw = curl_exec($ch);
curl_close($ch);

$response = json_decode($response_raw, true);
if ($response) {
    echo "nArchivos incluidos en la respuesta:n";
    echo "-----------------------------------n";
    
    if (isset($response['ind-estado'])) {
        echo "✓ Estado: " . $response['ind-estado'] . "n";
    }
    if (isset($response['FIRMADO'])) {
        echo "✓ XML Firmado (Base64)n";
        // Para guardar: file_put_contents('doc.xml', base64_decode($response['FIRMADO']));
    }
    if (isset($response['PDF'])) {
        echo "✓ PDF del documento (Base64)n";
        // Para guardar: file_put_contents('doc.pdf', base64_decode($response['PDF']));
    }
    if (isset($response['RESPUESTA_XML'])) {
        echo "✓ Respuesta de Hacienda (Base64)n";
        // Para guardar: file_put_contents('respuesta.xml', base64_decode($response['RESPUESTA_XML']));
    }
    
    echo "n💡 TIP: Los archivos vienen codificados en Base64.n";
    echo "Para guardarlos, usa base64_decode() antes de escribirlos.n";
} else {
    echo "n✗ ERROR al consultar el estadon";
    echo "Respuesta: " . $response_raw . "n";
}

echo "n═══════════════════════════════════════════════n";
echo "RESUMEN DE NIVELES DE RESPUESTAn";
echo "═══════════════════════════════════════════════n";
echo "ADJUNTOS = 0: Solo estado del documenton";
echo "ADJUNTOS = 1: Estado + XML firmadon";
echo "ADJUNTOS = 2: Estado + XML + Respuesta Haciendan";
echo "ADJUNTOS = 3: Estado + XML + PDF + Respuestan";
echo "nEstados posibles: aceptado, rechazado, procesandon";

echo "n═══════════════════════════════════════════════n";
echo "INSTRUCCIONES PARA PROBARn";
echo "═══════════════════════════════════════════════n";
echo "1. Ejecuta primero uno de los ejemplos 1-5 para timbrarn";
echo "2. Copia la clave de 50 caracteres generadan";
echo "3. Reemplaza la variable $clave_documento con esa claven";
echo "4. Ejecuta este script para ver el estadon";
echo "nNOTA: Los documentos nuevos pueden estar en estadon";
echo "'procesando' por unos minutos antes de ser aceptados.n";