Manual de Integración API REST (JSON)

<?php
$ch = curl_init('https://sandbox.integratucfdi.net/api/v1/generarComprobante');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-KEY: ak_test_sandbox_integratucfdi_2026',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'id' => 1, 'rfcemisor' => 'HECF750311V64', 'idcertificado' => 10494,
        'documento' => [
            'serie' => 'F', 'folio' => '1001', 'formapago' => '01', 'metodopago' => 'PUE', 'tipodocumento' => 'I', 'moneda' => 'MXN', 'subtotal' => '1000.00', 'total' => '1160.00', 'exportacion' => '01',
            'receptor' => ['rfc' => 'XAXX010101000', 'nombre' => 'PUBLICO EN GENERAL', 'usodelcomprobante' => 'S01', 'codigopostal' => '80000', 'regimenfiscal' => '616'],
            'conceptos' => [['clave' => '84111506', 'cantidad' => '1', 'codigounidad' => 'E48', 'unidad' => 'Servicio', 'descripcion' => 'Servicios de Software', 'valorUnitario' => '1000.00', 'importe' => '1000.00', 'objetoimpuesto' => '02']]
        ]
    ])
]);
$res = json_decode(curl_exec($ch), true);
if ($res['resultado']) {
    echo "UUID: " . $res['uuid'];
}
?>

<?php
$wsdl = "https://sandbox.integratucfdi.net/wscfdi.php?wsdl";
$client = new SoapClient($wsdl, array('trace' => 1, 'encoding' => 'UTF-8'));

$documento = array(
    'serie' => 'F', 'folio' => '1001', 'formapago' => '01', 'metodopago' => 'PUE', 'tipodocumento' => 'I', 'moneda' => 'MXN', 'subtotal' => '1000.00', 'total' => '1160.00', 'exportacion' => '01',
    'receptor' => array('rfc' => 'XAXX010101000', 'nombre' => 'PUBLICO EN GENERAL', 'usodelcomprobante' => 'S01', 'codigopostal' => '80000', 'regimenfiscal' => '616'),
    'conceptos' => array(
        array('clave' => '84111506', 'cantidad' => '1', 'codigounidad' => 'E48', 'unidad' => 'Servicio', 'descripcion' => 'Servicios de Software', 'valorUnitario' => '1000.00', 'importe' => '1000.00', 'objetoimpuesto' => '02')
    )
);

$res = $client->generarComprobante(1, 'HECF750311V64', 10494, $documento, 'pruebas', 'ee2ec3cc66427bb422894495068222a8');
if ($res->resultado) {
    file_put_contents("factura_" . $res->uuid . ".xml", $res->xml);
    file_put_contents("cbb_" . $res->uuid . ".jpg", base64_decode($res->cbb));
}
?>

using System.Net.Http.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-KEY", "ak_test_sandbox_integratucfdi_2026");

var payload = new {
    id = 1, rfcemisor = "HECF750311V64", idcertificado = 10494,
    documento = new {
        serie = "F", folio = "1001", formapago = "01", metodopago = "PUE", tipodocumento = "I", moneda = "MXN", subtotal = "1000.00", total = "1160.00", exportacion = "01",
        receptor = new { rfc = "XAXX010101000", nombre = "PUBLICO EN GENERAL", usodelcomprobante = "S01", codigopostal = "80000", regimenfiscal = "616" },
        conceptos = new[] { new { clave = "84111506", cantidad = "1", codigounidad = "E48", unidad = "Servicio", descripcion = "Servicios de Software", valorUnitario = "1000.00", importe = "1000.00", objetoimpuesto = "02" } }
    }
};

var response = await client.PostAsJsonAsync("https://sandbox.integratucfdi.net/api/v1/generarComprobante", payload);
var res = await response.Content.ReadFromJsonAsync<dynamic>();
Console.WriteLine("UUID REST: " + res?.uuid);

var binding = new BasicHttpBinding(BasicHttpSecurityMode.Transport);
var endpoint = new EndpointAddress("https://sandbox.integratucfdi.net/wscfdi.php");
var client = new wscfdiPortTypeClient(binding, endpoint);

var documentoFactura = new Dictionary<string, object> {
    { "serie", "F" }, { "folio", "1001" }, { "formapago", "01" }, { "metodopago", "PUE" }, { "tipodocumento", "I" }, { "moneda", "MXN" }, { "subtotal", "1000.00" }, { "total", "1160.00" }, { "exportacion", "01" },
    { "receptor", new Dictionary<string, string> { { "rfc", "XAXX010101000" }, { "nombre", "PUBLICO EN GENERAL" }, { "usodelcomprobante", "S01" }, { "codigopostal", "80000" }, { "regimenfiscal", "616" } } },
    { "conceptos", new[] { new Dictionary<string, string> { { "clave", "84111506" }, { "cantidad", "1" }, { "codigounidad", "E48" }, { "unidad", "Servicio" }, { "descripcion", "Servicios de Software" }, { "valorUnitario", "1000.00" }, { "importe", "1000.00" }, { "objetoimpuesto", "02" } } } }
};

var res = client.generarComprobante(1, "HECF750311V64", 10494, documentoFactura, "pruebas", "ee2ec3cc66427bb422894495068222a8");
if (res.resultado) {
    Console.WriteLine("UUID SOAP: " + res.uuid);
}

import requests

headers = {
    'X-API-KEY': 'ak_test_sandbox_integratucfdi_2026',
    'Content-Type': 'application/json'
}

payload = {
    'id': 1, 'rfcemisor': 'HECF750311V64', 'idcertificado': 10494,
    'documento': {
        'serie': 'F', 'folio': '1001', 'formapago': '01', 'metodopago': 'PUE', 'tipodocumento': 'I', 'moneda': 'MXN', 'subtotal': '1000.00', 'total': '1160.00', 'exportacion': '01',
        'receptor': {'rfc': 'XAXX010101000', 'nombre': 'PUBLICO EN GENERAL', 'usodelcomprobante': 'S01', 'codigopostal': '80000', 'regimenfiscal': '616'},
        'conceptos': [{'clave': '84111506', 'cantidad': '1', 'codigounidad': 'E48', 'unidad': 'Servicio', 'descripcion': 'Servicios de Software', 'valorUnitario': '1000.00', 'importe': '1000.00', 'objetoimpuesto': '02'}]
    }
}

res = requests.post('https://sandbox.integratucfdi.net/api/v1/generarComprobante', headers=headers, json=payload).json()
if res.get('resultado'):
    print(f"UUID REST: {res['uuid']}")

import zeep, base64

client = zeep.Client('https://sandbox.integratucfdi.net/wscfdi.php?wsdl')

doc = {
    'serie': 'F', 'folio': '1001', 'formapago': '01', 'metodopago': 'PUE', 'tipodocumento': 'I', 'moneda': 'MXN', 'subtotal': '1000.00', 'total': '1160.00', 'exportacion': '01',
    'receptor': {'rfc': 'XAXX010101000', 'nombre': 'PUBLICO EN GENERAL', 'usodelcomprobante': 'S01', 'codigopostal': '80000', 'regimenfiscal': '616'},
    'conceptos': [{'clave': '84111506', 'cantidad': '1', 'codigounidad': 'E48', 'unidad': 'Servicio', 'descripcion': 'Servicios de Software', 'valorUnitario': '1000.00', 'importe': '1000.00', 'objetoimpuesto': '02'}]
}

res = client.service.generarComprobante(id=1, rfcemisor='HECF750311V64', idcertificado=10494, documento=doc, usuario='pruebas', password='ee2ec3cc66427bb422894495068222a8')
if res.resultado:
    print(f"UUID SOAP: {res.uuid}")

{
    "resultado": true,
    "mensaje": "CFDI 4.0 Timbrado Exitosamente",
    "fechadocumento": "2026-08-23T13:30:00",
    "seriecertificado": "00001000000501234567",
    "sellodocumento": "iS7gK8M9xL2pQ5rT8yU1vW3xY5zA7bC9dE1fG3hI5jK7lM9nO1pQ3rS5tU7vW9xY1z...",
    "uuid": "4F92E391-89B2-4A73-A3B9-8F7E1B5D90A2",
    "fechatimbre": "2026-08-23T13:30:02",
    "seriecertificadosat": "00001000000504465028",
    "sellotimbre": "K7aP9mN4bV1cX8zY3wA5sD7fG9hJ1kL3mN5bP7rS9tU1vW3xY5zA7bC9dE1fG3hI...",
    "cadenaoriginal": "||1.1|4F92E391-89B2-4A73-A3B9-8F7E1B5D90A2|2026-08-23T13:30:02|SAT970701NN3|iS7gK8M9xL2pQ5rT8...||",
    "rfcpac": "SAT970701NN3",
    "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><cfdi:Comprobante .../>",
    "cbb": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAP...==",
    "archivos": "UEsDBBQAAAAIAI9lXFAAAAAA... [Archivo ZIP en Base64 con XML + CBB]"
}

<?php
$ch = curl_init('https://sandbox.integratucfdi.net/api/v1/generarComprobante');
curl_setopt_array($ch, [
    CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-KEY: ak_test_sandbox_integratucfdi_2026', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'id' => 1, 'rfcemisor' => 'HECF750311V64', 'idcertificado' => 10494,
        'documento' => [
            'serie' => 'CP', 'folio' => '3001', 'formapago' => '99', 'metodopago' => 'PPD', 'tipodocumento' => 'I', 'moneda' => 'MXN', 'subtotal' => '15000.00', 'total' => '17400.00', 'exportacion' => '01',
            'receptor' => ['rfc' => 'XAXX010101000', 'nombre' => 'CLIENTE LOGISTICA SA DE CV', 'usodelcomprobante' => 'G03', 'codigopostal' => '80000', 'regimenfiscal' => '601'],
            'conceptos' => [['clave' => '78101802', 'cantidad' => '1', 'codigounidad' => 'E48', 'unidad' => 'Servicio', 'descripcion' => 'Servicio de Flete', 'valorUnitario' => '15000.00', 'importe' => '15000.00', 'objetoimpuesto' => '02']],
            'cartaporte31' => ['TranspInternac' => 'No', 'TotalDistRec' => '450.00', 'Ubicaciones' => [...], 'Mercancias' => [...]]
        ]
    ])
]);
$res = json_decode(curl_exec($ch), true);
?>

<?php
$client = new SoapClient("https://sandbox.integratucfdi.net/wscfdi.php?wsdl");
$documento = array('serie' => 'CP', 'folio' => '3001', 'cartaporte31' => array(...));
$res = $client->generarComprobante(1, 'HECF750311V64', 10494, $documento, 'pruebas', 'ee2ec3cc66427bb422894495068222a8');
?>

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-KEY", "ak_test_sandbox_integratucfdi_2026");
var response = await client.PostAsJsonAsync("https://sandbox.integratucfdi.net/api/v1/generarComprobante", payload);

var client = new wscfdiPortTypeClient(binding, endpoint);
var res = client.generarComprobante(1, "HECF750311V64", 10494, doc, "pruebas", "ee2ec3cc66427bb422894495068222a8");

import requests
res = requests.post('https://sandbox.integratucfdi.net/api/v1/generarComprobante', headers={'X-API-KEY': 'ak_test_sandbox_integratucfdi_2026'}, json=payload).json()

import zeep
client = zeep.Client('https://sandbox.integratucfdi.net/wscfdi.php?wsdl')
res = client.service.generarComprobante(id=1, rfcemisor='HECF750311V64', idcertificado=10494, documento=doc, usuario='pruebas', password='ee2ec3cc66427bb422894495068222a8')

{
    "resultado": true,
    "mensaje": "CFDI 4.0 con Complemento Carta Porte 3.1 Timbrado Exitosamente",
    "uuid": "3E92A101-89C2-4B73-A3B9-9F8E1B5D90B3",
    "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><cfdi:Comprobante ...><cartaporte31:CartaPorte .../></cfdi:Comprobante>",
    "cbb": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAP...==",
    "archivos": "UEsDBBQAAAAIAI9lXFAAAAAA... [ZIP con XML + CBB]"
}