import requests

# Los tres valores estan en su panel de configuracion.
URL = "https://80200001.elementtech.com.py"  # URL base de su instancia
API_KEY = "tu_api_key"                       # API Key de la base
DB = "80200001_test"                         # Base de datos: _test o _prod

# Paso 1: iniciar sesion HTTP. Element necesita una cookie de sesion
# vinculada a la base de datos; sin ella las rutas responden 404.
session = requests.Session()
session.get(f"{URL}/web", params={"db": DB})

# Paso 2: headers de toda peticion autenticada. El servidor valida la
# API Key contra las claves registradas y ejecuta la peticion con los
# permisos del usuario propietario de la clave.
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "X-Database": DB,
    "Content-Type": "application/json"
}

// Requiere Node 18 o superior (fetch nativo). Sin dependencias.

// Los tres valores estan en su panel de configuracion.
const URL = "https://80200001.elementtech.com.py";  // URL base de su instancia
const API_KEY = "tu_api_key";                       // API Key de la base
const DB = "80200001_test";                         // Base de datos: _test o _prod

// Paso 1: iniciar sesion HTTP. Element necesita una cookie de sesion
// vinculada a la base de datos; sin ella las rutas responden 404.
// fetch no guarda cookies, asi que se reenvia a mano.
const inicio = await fetch(`${URL}/web?db=${DB}`, { redirect: "manual" });
const cookie = inicio.headers.get("set-cookie")?.match(/session_id=[^;]+/)?.[0] ?? "";

// Paso 2: headers de toda peticion autenticada. El servidor valida la
// API Key contra las claves registradas y ejecuta la peticion con los
// permisos del usuario propietario de la clave.
const headers = {
    "Authorization": `Bearer ${API_KEY}`,
    "X-Database": DB,
    "Content-Type": "application/json",
    "Cookie": cookie
};

// Requiere .NET 8 o superior. Sin paquetes externos.
using System.Net;
using System.Text;
using System.Text.Json;

// Los tres valores estan en su panel de configuracion.
const string URL = "https://80200001.elementtech.com.py";  // URL base de su instancia
const string API_KEY = "tu_api_key";                       // API Key de la base
const string DB = "80200001_test";                         // Base de datos: _test o _prod

// El CookieContainer conserva la cookie de sesion entre peticiones.
var handler = new HttpClientHandler { CookieContainer = new CookieContainer() };
var http = new HttpClient(handler) { Timeout = TimeSpan.FromSeconds(120) };

// El servidor valida la API Key contra las claves registradas y ejecuta
// la peticion con los permisos del usuario propietario de la clave.
http.DefaultRequestHeaders.Add("Authorization", $"Bearer {API_KEY}");
http.DefaultRequestHeaders.Add("X-Database", DB);

// Paso 1: iniciar sesion HTTP. Element necesita una cookie de sesion
// vinculada a la base de datos; sin ella las rutas responden 404.
await http.GetAsync($"{URL}/web?db={DB}");

// Paso 2: helper para el cuerpo JSON de las siguientes peticiones.
StringContent Json(object cuerpo) =>
    new(JsonSerializer.Serialize(cuerpo), Encoding.UTF8, "application/json");

// Requiere Java 17 o superior. Sin dependencias externas.
import java.net.CookieManager;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.util.function.Function;

// Los tres valores estan en su panel de configuracion.
String URL = "https://80200001.elementtech.com.py";  // URL base de su instancia
String API_KEY = "tu_api_key";                       // API Key de la base
String DB = "80200001_test";                         // Base de datos: _test o _prod

// El CookieManager conserva la cookie de sesion entre peticiones.
HttpClient http = HttpClient.newBuilder()
        .cookieHandler(new CookieManager())
        .connectTimeout(Duration.ofSeconds(120))
        .build();

// Paso 1: iniciar sesion HTTP. Element necesita una cookie de sesion
// vinculada a la base de datos; sin ella las rutas responden 404.
http.send(HttpRequest.newBuilder(URI.create(URL + "/web?db=" + DB)).build(),
        HttpResponse.BodyHandlers.discarding());

// Paso 2: constructor de peticiones ya autenticadas. El servidor valida
// la API Key contra las claves registradas y ejecuta la peticion con los
// permisos del usuario propietario de la clave.
Function<String, HttpRequest.Builder> pedido = ruta ->
        HttpRequest.newBuilder(URI.create(URL + ruta))
                .header("Authorization", "Bearer " + API_KEY)
                .header("X-Database", DB)
                .header("Content-Type", "application/json")
                .timeout(Duration.ofSeconds(120));

# Los tres valores estan en su panel de configuracion.
URL="https://80200001.elementtech.com.py"   # URL base de su instancia
API_KEY="tu_api_key"                        # API Key de la base
DB="80200001_test"                          # Base de datos: _test o _prod

# Paso 1: iniciar sesion HTTP y guardar la cookie. Element necesita una
# cookie de sesion vinculada a la base; sin ella las rutas responden 404.
curl -s -c cookies.txt -o /dev/null "$URL/web?db=$DB"

# Paso 2: a partir de aqui cada peticion reenvia la cookie con -b y
# los headers de autenticacion.

resp = session.post(
    f"{URL}/api/fe/invoice",
    headers=headers,
    json={
        # --- Identificacion del cliente ---
        # "partner_id" es el ID externo del cliente en su sistema.
        # Se usa como clave para buscar o crear el partner en Element.
        # Si el cliente ya fue creado con este mismo partner_id,
        # el sistema lo reutiliza automaticamente.
        "partner_id": "48213",

        # "api_ruc" activa la consulta automatica al servicio SIFEN.
        # El sistema consulta el RUC, obtiene nombre, tipo de
        # contribuyente y estado, y crea el partner con esos datos.
        # Formato: "numero-dv".
        "api_ruc": "80000001-1",

        # --- Lineas de la factura ---
        # "api_product_data" es OBLIGATORIO en cada linea.
        "lines": [{
            # ID externo del producto. Si ya existe uno con el mismo
            # "default_code", se reutiliza; si no, se crea.
            "product_id": "20458",
            "api_product_data": {
                "name": "Servicio de Consultoria",
                "default_code": "SRV-2045",  # Codigo interno (unico)
                "uom_id": 1,   # ID de unidad de medida en Element
                "tax_id": 1    # ID de impuesto en Element (ej: IVA 10%)
            },
            "quantity": 1,
            "price_unit": 150000   # Precio en la moneda de la factura
        }],

        # tipo_operacion: "1"=B2B, "2"=B2C (por omision), "3"=B2G, "4"=B2F.
        # El onchange de la interfaz no se dispara al crear por API, asi
        # que para B2B u otros tipos hay que enviarlo explicitamente.
        "tipo_operacion": "1"
    }
)
# La respuesta incluye id, numero, estado, montos y los datos del
# documento electronico (DE_estado, DE_id, etc.)
print(resp.json())

const resp = await fetch(`${URL}/api/fe/invoice`, {
    method: "POST",
    headers,
    body: JSON.stringify({
        // --- Identificacion del cliente ---
        // "partner_id" es el ID externo del cliente en su sistema.
        // Se usa como clave para buscar o crear el partner en Element.
        // Si el cliente ya fue creado con este mismo partner_id,
        // el sistema lo reutiliza automaticamente.
        partner_id: "48213",

        // "api_ruc" activa la consulta automatica al servicio SIFEN.
        // El sistema consulta el RUC, obtiene nombre, tipo de
        // contribuyente y estado, y crea el partner con esos datos.
        // Formato: "numero-dv".
        api_ruc: "80000001-1",

        // --- Lineas de la factura ---
        // "api_product_data" es OBLIGATORIO en cada linea.
        lines: [{
            // ID externo del producto. Si ya existe uno con el mismo
            // "default_code", se reutiliza; si no, se crea.
            product_id: "20458",
            api_product_data: {
                name: "Servicio de Consultoria",
                default_code: "SRV-2045",  // Codigo interno (unico)
                uom_id: 1,   // ID de unidad de medida en Element
                tax_id: 1    // ID de impuesto en Element (ej: IVA 10%)
            },
            quantity: 1,
            price_unit: 150000   // Precio en la moneda de la factura
        }],

        // tipo_operacion: "1"=B2B, "2"=B2C (por omision), "3"=B2G, "4"=B2F.
        // El onchange de la interfaz no se dispara al crear por API, asi
        // que para B2B u otros tipos hay que enviarlo explicitamente.
        tipo_operacion: "1"
    })
});
// La respuesta incluye id, numero, estado, montos y los datos del
// documento electronico (DE_estado, DE_id, etc.)
console.log(await resp.json());

var resp = await http.PostAsync($"{URL}/api/fe/invoice", Json(new
{
    // --- Identificacion del cliente ---
    // "partner_id" es el ID externo del cliente en su sistema.
    // Se usa como clave para buscar o crear el partner en Element.
    // Si el cliente ya fue creado con este mismo partner_id,
    // el sistema lo reutiliza automaticamente.
    partner_id = "48213",

    // "api_ruc" activa la consulta automatica al servicio SIFEN.
    // El sistema consulta el RUC, obtiene nombre, tipo de
    // contribuyente y estado, y crea el partner con esos datos.
    // Formato: "numero-dv".
    api_ruc = "80000001-1",

    // --- Lineas de la factura ---
    // "api_product_data" es OBLIGATORIO en cada linea.
    lines = new[]
    {
        new
        {
            // ID externo del producto. Si ya existe uno con el mismo
            // "default_code", se reutiliza; si no, se crea.
            product_id = "20458",
            api_product_data = new
            {
                name = "Servicio de Consultoria",
                default_code = "SRV-2045",  // Codigo interno (unico)
                uom_id = 1,   // ID de unidad de medida en Element
                tax_id = 1    // ID de impuesto en Element (ej: IVA 10%)
            },
            quantity = 1,
            price_unit = 150000   // Precio en la moneda de la factura
        }
    },

    // tipo_operacion: "1"=B2B, "2"=B2C (por omision), "3"=B2G, "4"=B2F.
    // El onchange de la interfaz no se dispara al crear por API, asi
    // que para B2B u otros tipos hay que enviarlo explicitamente.
    tipo_operacion = "1"
}));
// La respuesta incluye id, numero, estado, montos y los datos del
// documento electronico (DE_estado, DE_id, etc.)
Console.WriteLine(await resp.Content.ReadAsStringAsync());

// Sin dependencias externas el cuerpo se arma como texto. Con Jackson
// o Gson puede serializar un objeto en su lugar.
//   partner_id  ID externo del cliente en su sistema. Si ya existe un
//               cliente con ese partner_id, el sistema lo reutiliza.
//   api_ruc     activa la consulta automatica al servicio SIFEN: trae
//               nombre, tipo de contribuyente y estado. Formato "numero-dv".
//   lines       api_product_data es OBLIGATORIO en cada linea. Si ya existe
//               un producto con ese default_code, se reutiliza.
//   tipo_operacion  "1"=B2B, "2"=B2C (por omision), "3"=B2G, "4"=B2F. El
//               onchange de la interfaz no se dispara al crear por API.
String factura = """
        {
          "partner_id": "48213",
          "api_ruc": "80000001-1",
          "lines": [{
            "product_id": "20458",
            "api_product_data": {
              "name": "Servicio de Consultoria",
              "default_code": "SRV-2045",
              "uom_id": 1,
              "tax_id": 1
            },
            "quantity": 1,
            "price_unit": 150000
          }],
          "tipo_operacion": "1"
        }
        """;

HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/invoice")
                .POST(HttpRequest.BodyPublishers.ofString(factura))
                .build(),
        HttpResponse.BodyHandlers.ofString());
// La respuesta incluye id, numero, estado, montos y los datos del
// documento electronico (DE_estado, DE_id, etc.)
System.out.println(resp.body());

#   partner_id  ID externo del cliente en su sistema. Si ya existe un
#               cliente con ese partner_id, el sistema lo reutiliza.
#   api_ruc     activa la consulta automatica al servicio SIFEN: trae
#               nombre, tipo de contribuyente y estado. Formato "numero-dv".
#   lines       api_product_data es OBLIGATORIO en cada linea. Si ya existe
#               un producto con ese default_code, se reutiliza.
#   tipo_operacion  "1"=B2B, "2"=B2C (por omision), "3"=B2G, "4"=B2F. El
#               onchange de la interfaz no se dispara al crear por API.
curl -s -b cookies.txt -X POST "$URL/api/fe/invoice" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  -H "Content-Type: application/json" \
  -d '{
    "partner_id": "48213",
    "api_ruc": "80000001-1",
    "lines": [{
      "product_id": "20458",
      "api_product_data": {
        "name": "Servicio de Consultoria",
        "default_code": "SRV-2045",
        "uom_id": 1,
        "tax_id": 1
      },
      "quantity": 1,
      "price_unit": 150000
    }],
    "tipo_operacion": "1"
  }'

resp = session.post(
    f"{URL}/api/fe/invoice",
    headers=headers,
    json={
        # --- Cliente con datos manuales (sin consulta SIFEN) ---
        # En lugar de api_ruc se usa api_partner_data. El sistema busca
        # primero si ya existe un partner con ese RUC; si lo encuentra,
        # lo reutiliza sin crear uno nuevo.
        "partner_id": "51742",
        "api_partner_data": {
            "name": "Empresa Cliente SA",
            "ruc": "80012345-6",  # RUC con digito verificador
            # Al incluir "ruc" el cliente queda marcado como contribuyente.
            # "company_type" define si el XML lo informa como persona
            # fisica (1) o juridica (2).
            "company_type": 2,

            # Correo del cliente. Va en el XML del DE y es el destinatario
            # del envio automatico del documento.
            "email": "[email protected]",
            "phone": "021445566",

            # Direccion del cliente. Los cinco campos siguientes deben
            # enviarse juntos para que la direccion aparezca en el XML.
            "street": "Avda. Mariscal Lopez 1234",
            "numero_casa": "1234",
            # Los campos geograficos aceptan ID numerico o nombre.
            "departamento_id": "Central",
            "distrito_id": "Luque",
            "ciudad_id": "Luque",
            "barrio_id": "Centro"   # Opcional
        },

        # Termino de pago: ID del registro payment.term en Element.
        # Si el termino tiene dias > 0 la factura es a credito y el
        # sistema NO registra pago automatico.
        "payment_term_id": 2,

        "lines": [{
            # Cuando product_id es un entero se interpreta como el ID
            # interno de Element y el producto debe existir.
            "product_id": 1,
            "quantity": 2,
            "price_unit": 250000
        }]
    }
)
print(resp.json())

const resp = await fetch(`${URL}/api/fe/invoice`, {
    method: "POST",
    headers,
    body: JSON.stringify({
        // --- Cliente con datos manuales (sin consulta SIFEN) ---
        // En lugar de api_ruc se usa api_partner_data. El sistema busca
        // primero si ya existe un partner con ese RUC; si lo encuentra,
        // lo reutiliza sin crear uno nuevo.
        partner_id: "51742",
        api_partner_data: {
            name: "Empresa Cliente SA",
            ruc: "80012345-6",  // RUC con digito verificador
            // Al incluir "ruc" el cliente queda marcado como contribuyente.
            // "company_type" define si el XML lo informa como persona
            // fisica (1) o juridica (2).
            company_type: 2,

            // Correo del cliente. Va en el XML del DE y es el destinatario
            // del envio automatico del documento.
            email: "[email protected]",
            phone: "021445566",

            // Direccion del cliente. Los cinco campos siguientes deben
            // enviarse juntos para que la direccion aparezca en el XML.
            street: "Avda. Mariscal Lopez 1234",
            numero_casa: "1234",
            // Los campos geograficos aceptan ID numerico o nombre.
            departamento_id: "Central",
            distrito_id: "Luque",
            ciudad_id: "Luque",
            barrio_id: "Centro"   // Opcional
        },

        // Termino de pago: ID del registro payment.term en Element.
        // Si el termino tiene dias > 0 la factura es a credito y el
        // sistema NO registra pago automatico.
        payment_term_id: 2,

        lines: [{
            // Cuando product_id es un entero se interpreta como el ID
            // interno de Element y el producto debe existir.
            product_id: 1,
            quantity: 2,
            price_unit: 250000
        }]
    })
});
console.log(await resp.json());

var resp = await http.PostAsync($"{URL}/api/fe/invoice", Json(new
{
    // --- Cliente con datos manuales (sin consulta SIFEN) ---
    // En lugar de api_ruc se usa api_partner_data. El sistema busca
    // primero si ya existe un partner con ese RUC; si lo encuentra,
    // lo reutiliza sin crear uno nuevo.
    partner_id = "51742",
    api_partner_data = new
    {
        name = "Empresa Cliente SA",
        ruc = "80012345-6",  // RUC con digito verificador
        // Al incluir "ruc" el cliente queda marcado como contribuyente.
        // "company_type" define si el XML lo informa como persona
        // fisica (1) o juridica (2).
        company_type = 2,

        // Correo del cliente. Va en el XML del DE y es el destinatario
        // del envio automatico del documento.
        email = "[email protected]",
        phone = "021445566",

        // Direccion del cliente. Los cinco campos siguientes deben
        // enviarse juntos para que la direccion aparezca en el XML.
        street = "Avda. Mariscal Lopez 1234",
        numero_casa = "1234",
        // Los campos geograficos aceptan ID numerico o nombre.
        departamento_id = "Central",
        distrito_id = "Luque",
        ciudad_id = "Luque",
        barrio_id = "Centro"   // Opcional
    },

    // Termino de pago: ID del registro payment.term en Element.
    // Si el termino tiene dias > 0 la factura es a credito y el
    // sistema NO registra pago automatico.
    payment_term_id = 2,

    lines = new[]
    {
        new
        {
            // Cuando product_id es un entero se interpreta como el ID
            // interno de Element y el producto debe existir.
            product_id = 1,
            quantity = 2,
            price_unit = 250000
        }
    }
}));
Console.WriteLine(await resp.Content.ReadAsStringAsync());

// api_partner_data reemplaza a api_ruc: los datos del cliente van
// explicitos y no se consulta SIFEN. Si ya existe un partner con ese
// RUC, se reutiliza. Los campos geograficos aceptan ID o nombre, y
// payment_term_id con dias > 0 marca la factura como a credito.
String factura = """
        {
          "partner_id": "51742",
          "api_partner_data": {
            "name": "Empresa Cliente SA",
            "ruc": "80012345-6",
            "company_type": 2,
            "email": "[email protected]",
            "phone": "021445566",
            "street": "Avda. Mariscal Lopez 1234",
            "numero_casa": "1234",
            "departamento_id": "Central",
            "distrito_id": "Luque",
            "ciudad_id": "Luque",
            "barrio_id": "Centro"
          },
          "payment_term_id": 2,
          "lines": [{
            "product_id": 1,
            "quantity": 2,
            "price_unit": 250000
          }]
        }
        """;

HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/invoice")
                .POST(HttpRequest.BodyPublishers.ofString(factura))
                .build(),
        HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

# api_partner_data reemplaza a api_ruc: los datos del cliente van
# explicitos y no se consulta SIFEN. Si ya existe un partner con ese
# RUC, se reutiliza. Los campos geograficos aceptan ID o nombre, y
# payment_term_id con dias > 0 marca la factura como a credito.
curl -s -b cookies.txt -X POST "$URL/api/fe/invoice" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  -H "Content-Type: application/json" \
  -d '{
    "partner_id": "51742",
    "api_partner_data": {
      "name": "Empresa Cliente SA",
      "ruc": "80012345-6",
      "company_type": 2,
      "email": "[email protected]",
      "phone": "021445566",
      "street": "Avda. Mariscal Lopez 1234",
      "numero_casa": "1234",
      "departamento_id": "Central",
      "distrito_id": "Luque",
      "ciudad_id": "Luque",
      "barrio_id": "Centro"
    },
    "payment_term_id": 2,
    "lines": [{
      "product_id": 1,
      "quantity": 2,
      "price_unit": 250000
    }]
  }'

# Para personas fisicas (no contribuyentes) se usa "ci" en lugar de
# "ruc". El partner se crea con contribuyente=False,
# company_type="person" y el tipo_documento indicado.
resp = session.post(
    f"{URL}/api/fe/invoice",
    headers=headers,
    json={
        "partner_id": "63189",
        "api_partner_data": {
            "name": "Juan Perez",
            "ci": "1234567",          # Numero de cedula de identidad
            "tipo_documento": "1",    # "1" = Cedula de identidad paraguaya.
                                      # Para otros documentos (pasaporte,
                                      # cedula extranjera, etc.) se envian
                                      # "tipo_documento" y "documento_numero"
                                      # en lugar de "ci".
            "email": "[email protected]"
        },
        "lines": [{
            "product_id": "20458",
            "api_product_data": {
                "name": "Servicio de Consultoria",
                "default_code": "SRV-2045",
                "uom_id": 1,
                "tax_id": 1
            },
            "quantity": 1,
            "price_unit": 90000
        }]
    }
)
print(resp.json())

// Para personas fisicas (no contribuyentes) se usa "ci" en lugar de
// "ruc". El partner se crea con contribuyente=false,
// company_type="person" y el tipo_documento indicado.
const resp = await fetch(`${URL}/api/fe/invoice`, {
    method: "POST",
    headers,
    body: JSON.stringify({
        partner_id: "63189",
        api_partner_data: {
            name: "Juan Perez",
            ci: "1234567",          // Numero de cedula de identidad
            tipo_documento: "1",    // "1" = Cedula de identidad paraguaya.
                                    // Para otros documentos (pasaporte,
                                    // cedula extranjera, etc.) se envian
                                    // "tipo_documento" y "documento_numero"
                                    // en lugar de "ci".
            email: "[email protected]"
        },
        lines: [{
            product_id: "20458",
            api_product_data: {
                name: "Servicio de Consultoria",
                default_code: "SRV-2045",
                uom_id: 1,
                tax_id: 1
            },
            quantity: 1,
            price_unit: 90000
        }]
    })
});
console.log(await resp.json());

// Para personas fisicas (no contribuyentes) se usa "ci" en lugar de
// "ruc". El partner se crea con contribuyente=false,
// company_type="person" y el tipo_documento indicado.
var resp = await http.PostAsync($"{URL}/api/fe/invoice", Json(new
{
    partner_id = "63189",
    api_partner_data = new
    {
        name = "Juan Perez",
        ci = "1234567",          // Numero de cedula de identidad
        tipo_documento = "1",    // "1" = Cedula de identidad paraguaya.
                                 // Para otros documentos (pasaporte,
                                 // cedula extranjera, etc.) se envian
                                 // "tipo_documento" y "documento_numero"
                                 // en lugar de "ci".
        email = "[email protected]"
    },
    lines = new[]
    {
        new
        {
            product_id = "20458",
            api_product_data = new
            {
                name = "Servicio de Consultoria",
                default_code = "SRV-2045",
                uom_id = 1,
                tax_id = 1
            },
            quantity = 1,
            price_unit = 90000
        }
    }
}));
Console.WriteLine(await resp.Content.ReadAsStringAsync());

// Para personas fisicas (no contribuyentes) se usa "ci" en lugar de
// "ruc". El partner se crea con contribuyente=false,
// company_type="person" y el tipo_documento indicado.
// tipo_documento "1" es la cedula de identidad paraguaya. Para otros
// documentos (pasaporte, cedula extranjera, etc.) se envian
// "tipo_documento" y "documento_numero" en lugar de "ci".
String factura = """
        {
          "partner_id": "63189",
          "api_partner_data": {
            "name": "Juan Perez",
            "ci": "1234567",
            "tipo_documento": "1",
            "email": "[email protected]"
          },
          "lines": [{
            "product_id": "20458",
            "api_product_data": {
              "name": "Servicio de Consultoria",
              "default_code": "SRV-2045",
              "uom_id": 1,
              "tax_id": 1
            },
            "quantity": 1,
            "price_unit": 90000
          }]
        }
        """;

HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/invoice")
                .POST(HttpRequest.BodyPublishers.ofString(factura))
                .build(),
        HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

# Para personas fisicas (no contribuyentes) se usa "ci" en lugar de
# "ruc". El partner se crea con contribuyente=false,
# company_type="person" y el tipo_documento indicado.
# tipo_documento "1" es la cedula de identidad paraguaya. Para otros
# documentos (pasaporte, cedula extranjera, etc.) se envian
# "tipo_documento" y "documento_numero" en lugar de "ci".
curl -s -b cookies.txt -X POST "$URL/api/fe/invoice" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  -H "Content-Type: application/json" \
  -d '{
    "partner_id": "63189",
    "api_partner_data": {
      "name": "Juan Perez",
      "ci": "1234567",
      "tipo_documento": "1",
      "email": "[email protected]"
    },
    "lines": [{
      "product_id": "20458",
      "api_product_data": {
        "name": "Servicio de Consultoria",
        "default_code": "SRV-2045",
        "uom_id": 1,
        "tax_id": 1
      },
      "quantity": 1,
      "price_unit": 90000
    }]
  }'

resp = session.post(
    f"{URL}/api/fe/invoice",
    headers=headers,
    json={
        "partner_id": "731845290",
        "api_partner_data": {
            "name": "Comercial Exemplo Ltda",
            "company_type": 2,
            "country_id": "BR",
            "street": "Rua das Flores 100",
            "tipo_documento": "9",
            "tipo_documento_descripcion": "Cadastro Nacional PJ",
            "documento_numero": "12345678000190",
            "email": "[email protected]"
        },
        "currency": "USD",
        "tipo_cambio": 7300,        # Gs. por 1 USD (ver mas abajo)
        "tipo_transaccion": "2",    # Prestacion de servicios
        "presencia": "2",           # Operacion electronica
        "lines": [{
            "product_id": "516131942",
            "api_product_data": {
                "name": "Servicio de consultoria",
                "default_code": "78465791",
                "uom_id": 1,
                "iva": "exento"     # o "10" / "5", segun la operacion
            },
            "quantity": 1,
            "price_unit": 1500
        }]
    }
)
print(resp.json())

const resp = await fetch(`${URL}/api/fe/invoice`, {
    method: "POST",
    headers,
    body: JSON.stringify({
        partner_id: "731845290",
        api_partner_data: {
            name: "Comercial Exemplo Ltda",
            company_type: 2,
            country_id: "BR",
            street: "Rua das Flores 100",
            tipo_documento: "9",
            tipo_documento_descripcion: "Cadastro Nacional PJ",
            documento_numero: "12345678000190",
            email: "[email protected]"
        },
        currency: "USD",
        tipo_cambio: 7300,        // Gs. por 1 USD (ver mas abajo)
        tipo_transaccion: "2",    // Prestacion de servicios
        presencia: "2",           // Operacion electronica
        lines: [{
            product_id: "516131942",
            api_product_data: {
                name: "Servicio de consultoria",
                default_code: "78465791",
                uom_id: 1,
                iva: "exento"     // o "10" / "5", segun la operacion
            },
            quantity: 1,
            price_unit: 1500
        }]
    })
});
console.log(await resp.json());

var resp = await http.PostAsync($"{URL}/api/fe/invoice", Json(new
{
    partner_id = "731845290",
    api_partner_data = new
    {
        name = "Comercial Exemplo Ltda",
        company_type = 2,
        country_id = "BR",
        street = "Rua das Flores 100",
        tipo_documento = "9",
        tipo_documento_descripcion = "Cadastro Nacional PJ",
        documento_numero = "12345678000190",
        email = "[email protected]"
    },
    currency = "USD",
    tipo_cambio = 7300,        // Gs. por 1 USD (ver mas abajo)
    tipo_transaccion = "2",    // Prestacion de servicios
    presencia = "2",           // Operacion electronica
    lines = new[]
    {
        new
        {
            product_id = "516131942",
            api_product_data = new
            {
                name = "Servicio de consultoria",
                default_code = "78465791",
                uom_id = 1,
                iva = "exento"     // o "10" / "5", segun la operacion
            },
            quantity = 1,
            price_unit = 1500
        }
    }
}));
Console.WriteLine(await resp.Content.ReadAsStringAsync());

// tipo_cambio: Gs. por 1 USD (ver mas abajo).
// tipo_transaccion "2" = prestacion de servicios; presencia "2" = operacion electronica.
// iva: "exento", "10" o "5", segun la operacion.
String factura = """
        {
          "partner_id": "731845290",
          "api_partner_data": {
            "name": "Comercial Exemplo Ltda",
            "company_type": 2,
            "country_id": "BR",
            "street": "Rua das Flores 100",
            "tipo_documento": "9",
            "tipo_documento_descripcion": "Cadastro Nacional PJ",
            "documento_numero": "12345678000190",
            "email": "[email protected]"
          },
          "currency": "USD",
          "tipo_cambio": 7300,
          "tipo_transaccion": "2",
          "presencia": "2",
          "lines": [{
            "product_id": "516131942",
            "api_product_data": {
              "name": "Servicio de consultoria",
              "default_code": "78465791",
              "uom_id": 1,
              "iva": "exento"
            },
            "quantity": 1,
            "price_unit": 1500
          }]
        }
        """;

HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/invoice")
                .POST(HttpRequest.BodyPublishers.ofString(factura))
                .build(),
        HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

# tipo_cambio: Gs. por 1 USD (ver mas abajo).
# tipo_transaccion "2" = prestacion de servicios; presencia "2" = operacion electronica.
# iva: "exento", "10" o "5", segun la operacion.
curl -s -b cookies.txt -X POST "$URL/api/fe/invoice" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  -H "Content-Type: application/json" \
  -d '{
    "partner_id": "731845290",
    "api_partner_data": {
      "name": "Comercial Exemplo Ltda",
      "company_type": 2,
      "country_id": "BR",
      "street": "Rua das Flores 100",
      "tipo_documento": "9",
      "tipo_documento_descripcion": "Cadastro Nacional PJ",
      "documento_numero": "12345678000190",
      "email": "[email protected]"
    },
    "currency": "USD",
    "tipo_cambio": 7300,
    "tipo_transaccion": "2",
    "presencia": "2",
    "lines": [{
      "product_id": "516131942",
      "api_product_data": {
        "name": "Servicio de consultoria",
        "default_code": "78465791",
        "uom_id": 1,
        "iva": "exento"
      },
      "quantity": 1,
      "price_unit": 1500
    }]
  }'

"api_partner_data": {
    "name": "Martina Fernandez",
    "country_id": "AR",
    "street": "Av. Corrientes 1234",
    "tipo_documento": "2",
    "documento_numero": "AAA123456"
}

"exportacion": {
    "condicion_negociacion": "FOB",
    "empresa_fletera": "Transportes Ejemplo SA",
    "agente_transporte": "Agencia Maritima Ejemplo",
    "numero_conocimiento_embarque": "241578963",
    "instrucciones_pago": "Transferencia a la cuenta en USD"
}

resp = session.post(
    f"{URL}/api/fe/partner/by-document/12345678000190/update",
    headers=headers,
    json={"street": "Rua Nova 200", "country_id": "BR"}
)
print(resp.json())

const resp = await fetch(`${URL}/api/fe/partner/by-document/12345678000190/update`, {
    method: "POST",
    headers,
    body: JSON.stringify({ street: "Rua Nova 200", country_id: "BR" })
});
console.log(await resp.json());

var resp = await http.PostAsync(
    $"{URL}/api/fe/partner/by-document/12345678000190/update",
    Json(new { street = "Rua Nova 200", country_id = "BR" }));
Console.WriteLine(await resp.Content.ReadAsStringAsync());

HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/partner/by-document/12345678000190/update")
                .POST(HttpRequest.BodyPublishers.ofString(
                        "{\"street\": \"Rua Nova 200\", \"country_id\": \"BR\"}"))
                .build(),
        HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

curl -s -b cookies.txt -X POST "$URL/api/fe/partner/by-document/12345678000190/update" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  -H "Content-Type: application/json" \
  -d '{"street": "Rua Nova 200", "country_id": "BR"}'

{
    "success": false,
    "error": {
        "code": "RECEPTOR_EXTERIOR_INCOMPLETO",
        "message": "Faltan datos del cliente del exterior Comercial Exemplo Ltda: falta 'street': la direccion es obligatoria en B2F; falta 'documento_numero'"
    }
}

resp = session.post(
    f"{URL}/api/fe/credit-note",
    headers=headers,
    json={
        # Numero de la factura original a la que aplica la NC. El sistema
        # la busca y vincula la NC mediante "reversed_entry_id".
        # Alternativa: "original_invoice_id" con el ID numerico de Element.
        "original_invoice_number": "001-001-0004661",

        # Codigo de motivo segun normativa SIFEN. Se almacena en
        # "motivo_nota_credito_debito". Ver la tabla de motivos mas arriba.
        "motivo": "1",  # 1 = Devolucion y Ajuste de precios

        # Lineas propias de la NC. Si se omite "lines" el sistema copia
        # las lineas de la factura original; con "amount_factor" (ej: 0.5)
        # se genera una NC parcial.
        "lines": [{
            "product_id": "20458",
            "api_product_data": {
                "name": "Servicio a devolver",
                "default_code": "SRV-2045",
                "uom_id": 1,
                "tax_id": 1
            },
            "quantity": 1,
            "price_unit": 100000
        }]
    }
)
print(resp.json())

const resp = await fetch(`${URL}/api/fe/credit-note`, {
    method: "POST",
    headers,
    body: JSON.stringify({
        // Numero de la factura original a la que aplica la NC. El sistema
        // la busca y vincula la NC mediante "reversed_entry_id".
        // Alternativa: "original_invoice_id" con el ID numerico de Element.
        original_invoice_number: "001-001-0004661",

        // Codigo de motivo segun normativa SIFEN. Se almacena en
        // "motivo_nota_credito_debito". Ver la tabla de motivos mas arriba.
        motivo: "1",  // 1 = Devolucion y Ajuste de precios

        // Lineas propias de la NC. Si se omite "lines" el sistema copia
        // las lineas de la factura original; con "amount_factor" (ej: 0.5)
        // se genera una NC parcial.
        lines: [{
            product_id: "20458",
            api_product_data: {
                name: "Servicio a devolver",
                default_code: "SRV-2045",
                uom_id: 1,
                tax_id: 1
            },
            quantity: 1,
            price_unit: 100000
        }]
    })
});
console.log(await resp.json());

var resp = await http.PostAsync($"{URL}/api/fe/credit-note", Json(new
{
    // Numero de la factura original a la que aplica la NC. El sistema
    // la busca y vincula la NC mediante "reversed_entry_id".
    // Alternativa: "original_invoice_id" con el ID numerico de Element.
    original_invoice_number = "001-001-0004661",

    // Codigo de motivo segun normativa SIFEN. Se almacena en
    // "motivo_nota_credito_debito". Ver la tabla de motivos mas arriba.
    motivo = "1",  // 1 = Devolucion y Ajuste de precios

    // Lineas propias de la NC. Si se omite "lines" el sistema copia
    // las lineas de la factura original; con "amount_factor" (ej: 0.5)
    // se genera una NC parcial.
    lines = new[]
    {
        new
        {
            product_id = "20458",
            api_product_data = new
            {
                name = "Servicio a devolver",
                default_code = "SRV-2045",
                uom_id = 1,
                tax_id = 1
            },
            quantity = 1,
            price_unit = 100000
        }
    }
}));
Console.WriteLine(await resp.Content.ReadAsStringAsync());

// original_invoice_number identifica la factura a la que aplica la NC; el
// sistema la vincula mediante reversed_entry_id. Alternativa:
// original_invoice_id con el ID numerico de Element.
// motivo es el codigo SIFEN (1 = Devolucion y Ajuste de precios).
// Si se omite "lines" se copian las lineas de la factura original; con
// amount_factor (ej: 0.5) se genera una NC parcial.
String notaCredito = """
        {
          "original_invoice_number": "001-001-0004661",
          "motivo": "1",
          "lines": [{
            "product_id": "20458",
            "api_product_data": {
              "name": "Servicio a devolver",
              "default_code": "SRV-2045",
              "uom_id": 1,
              "tax_id": 1
            },
            "quantity": 1,
            "price_unit": 100000
          }]
        }
        """;

HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/credit-note")
                .POST(HttpRequest.BodyPublishers.ofString(notaCredito))
                .build(),
        HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

# original_invoice_number identifica la factura a la que aplica la NC; el
# sistema la vincula mediante reversed_entry_id. Alternativa:
# original_invoice_id con el ID numerico de Element.
# motivo es el codigo SIFEN (1 = Devolucion y Ajuste de precios).
# Si se omite "lines" se copian las lineas de la factura original; con
# amount_factor (ej: 0.5) se genera una NC parcial.
curl -s -b cookies.txt -X POST "$URL/api/fe/credit-note" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  -H "Content-Type: application/json" \
  -d '{
    "original_invoice_number": "001-001-0004661",
    "motivo": "1",
    "lines": [{
      "product_id": "20458",
      "api_product_data": {
        "name": "Servicio a devolver",
        "default_code": "SRV-2045",
        "uom_id": 1,
        "tax_id": 1
      },
      "quantity": 1,
      "price_unit": 100000
    }]
  }'

resp = session.get(
    f"{URL}/api/fe/invoice/001-001-0004707",
    headers=headers
)

# Con filtro de tipo, cuando el numero es ambiguo entre factura y NC:
resp = session.get(
    f"{URL}/api/fe/invoice/001-001-0004707?move_type=invoice",
    headers=headers
)
print(resp.json())

let resp = await fetch(`${URL}/api/fe/invoice/001-001-0004707`, { headers });

// Con filtro de tipo, cuando el numero es ambiguo entre factura y NC:
resp = await fetch(`${URL}/api/fe/invoice/001-001-0004707?move_type=invoice`, { headers });
console.log(await resp.json());

var resp = await http.GetAsync($"{URL}/api/fe/invoice/001-001-0004707");

// Con filtro de tipo, cuando el numero es ambiguo entre factura y NC:
resp = await http.GetAsync($"{URL}/api/fe/invoice/001-001-0004707?move_type=invoice");
Console.WriteLine(await resp.Content.ReadAsStringAsync());

HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/invoice/001-001-0004707").GET().build(),
        HttpResponse.BodyHandlers.ofString());

// Con filtro de tipo, cuando el numero es ambiguo entre factura y NC:
resp = http.send(
        pedido.apply("/api/fe/invoice/001-001-0004707?move_type=invoice").GET().build(),
        HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

curl -s -b cookies.txt "$URL/api/fe/invoice/001-001-0004707" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB"

# Con filtro de tipo, cuando el numero es ambiguo entre factura y NC:
curl -s -b cookies.txt "$URL/api/fe/invoice/001-001-0004707?move_type=invoice" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB"

resp = session.post(
    f"{URL}/api/fe/invoice/001-001-0004707/cancel",
    headers=headers,
    json={
        "motivo": "Solicitud de anulacion del cliente",
        # "move_type": "invoice"  # incluir si el numero es ambiguo
    }
)
print(resp.json())

const resp = await fetch(`${URL}/api/fe/invoice/001-001-0004707/cancel`, {
    method: "POST",
    headers,
    body: JSON.stringify({
        motivo: "Solicitud de anulacion del cliente"
        // move_type: "invoice"  // incluir si el numero es ambiguo
    })
});
console.log(await resp.json());

var resp = await http.PostAsync($"{URL}/api/fe/invoice/001-001-0004707/cancel", Json(new
{
    motivo = "Solicitud de anulacion del cliente"
    // move_type = "invoice"  // incluir si el numero es ambiguo
}));
Console.WriteLine(await resp.Content.ReadAsStringAsync());

// move_type ("invoice" o "credit_note") solo hace falta si el numero es
// ambiguo entre una factura y una nota de credito.
String cancelacion = """
        {"motivo": "Solicitud de anulacion del cliente"}
        """;

HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/invoice/001-001-0004707/cancel")
                .POST(HttpRequest.BodyPublishers.ofString(cancelacion))
                .build(),
        HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

# move_type ("invoice" o "credit_note") solo hace falta si el numero es
# ambiguo entre una factura y una nota de credito.
curl -s -b cookies.txt -X POST "$URL/api/fe/invoice/001-001-0004707/cancel" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  -H "Content-Type: application/json" \
  -d '{"motivo": "Solicitud de anulacion del cliente"}'

# Registra un pago para una factura ya publicada (posted). Usa el wizard
# "account.payment.register" de Element. La factura debe estar en
# state="posted" y no estar pagada, si no devuelve INVALID_STATE
# o ALREADY_PAID.
resp = session.post(
    # El {id} de la URL es el ID numerico de la factura en Element
    # (campo "id" que devuelve crearla o buscarla), no su numero.
    f"{URL}/api/fe/invoice/123/payment",
    headers=headers,
    json={
        # Tipo de diario de pago: "cash" (caja, por omision) o "bank"
        # (transferencia). Con "payment_journal_id" se indica un diario
        # concreto en lugar del tipo.
        "journal_type": "cash",

        # Monto del pago. Si se omite se cobra el total pendiente
        # (amount_residual). Un monto menor genera un pago parcial.
        "amount": 50000
    }
)
# Respuesta: payment_id, payment_name, invoice_payment_state
print(resp.json())

// Registra un pago para una factura ya publicada (posted). Usa el wizard
// "account.payment.register" de Element. La factura debe estar en
// state="posted" y no estar pagada, si no devuelve INVALID_STATE
// o ALREADY_PAID.
// El {id} de la URL es el ID numerico de la factura en Element
// (campo "id" que devuelve crearla o buscarla), no su numero.
const resp = await fetch(`${URL}/api/fe/invoice/123/payment`, {
    method: "POST",
    headers,
    body: JSON.stringify({
        // Tipo de diario de pago: "cash" (caja, por omision) o "bank"
        // (transferencia). Con "payment_journal_id" se indica un diario
        // concreto en lugar del tipo.
        journal_type: "cash",

        // Monto del pago. Si se omite se cobra el total pendiente
        // (amount_residual). Un monto menor genera un pago parcial.
        amount: 50000
    })
});
// Respuesta: payment_id, payment_name, invoice_payment_state
console.log(await resp.json());

// Registra un pago para una factura ya publicada (posted). Usa el wizard
// "account.payment.register" de Element. La factura debe estar en
// state="posted" y no estar pagada, si no devuelve INVALID_STATE
// o ALREADY_PAID.
// El {id} de la URL es el ID numerico de la factura en Element
// (campo "id" que devuelve crearla o buscarla), no su numero.
var resp = await http.PostAsync($"{URL}/api/fe/invoice/123/payment", Json(new
{
    // Tipo de diario de pago: "cash" (caja, por omision) o "bank"
    // (transferencia). Con "payment_journal_id" se indica un diario
    // concreto en lugar del tipo.
    journal_type = "cash",

    // Monto del pago. Si se omite se cobra el total pendiente
    // (amount_residual). Un monto menor genera un pago parcial.
    amount = 50000
}));
// Respuesta: payment_id, payment_name, invoice_payment_state
Console.WriteLine(await resp.Content.ReadAsStringAsync());

// Registra un pago para una factura ya publicada (posted). Usa el wizard
// "account.payment.register" de Element. La factura debe estar en
// state="posted" y no estar pagada, si no devuelve INVALID_STATE
// o ALREADY_PAID.
// El {id} de la URL es el ID numerico de la factura en Element (campo "id"
// que devuelve crearla o buscarla), no su numero.
//   journal_type  "cash" (caja, por omision) o "bank" (transferencia). Con
//                 payment_journal_id se indica un diario concreto.
//   amount        si se omite se cobra el total pendiente (amount_residual).
String pago = """
        {"journal_type": "cash", "amount": 50000}
        """;

HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/invoice/123/payment")
                .POST(HttpRequest.BodyPublishers.ofString(pago))
                .build(),
        HttpResponse.BodyHandlers.ofString());
// Respuesta: payment_id, payment_name, invoice_payment_state
System.out.println(resp.body());

# Registra un pago para una factura ya publicada (posted). La factura debe
# estar en state="posted" y no estar pagada, si no devuelve INVALID_STATE
# o ALREADY_PAID.
# El {id} de la URL es el ID numerico de la factura en Element (campo "id"
# que devuelve crearla o buscarla), no su numero.
#   journal_type  "cash" (caja, por omision) o "bank" (transferencia). Con
#                 payment_journal_id se indica un diario concreto.
#   amount        si se omite se cobra el total pendiente (amount_residual).
curl -s -b cookies.txt -X POST "$URL/api/fe/invoice/123/payment" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  -H "Content-Type: application/json" \
  -d '{"journal_type": "cash", "amount": 50000}'

resp = session.post(
    f"{URL}/api/fe/remision",
    headers=headers,
    json={
        # --- Cliente destinatario ---
        # ID externo. Si ya existe el partner mapeado se reutiliza; en caso
        # contrario se crea con los datos de api_partner_data.
        "partner_id": "48214",
        "api_partner_data": {
            "name": "Distribuidora ABC S.A.",
            "ruc": "80123456-7",       # RUC con digito verificador
            "company_type": 2,         # 2=empresa, 1=persona
            "email": "[email protected]",
            # Datos geograficos: aceptan ID numerico o nombre en texto.
            # La API resuelve los IDs segun la jerarquia SIFEN.
            "departamento_id": "Central",
            "distrito_id": "Luque",
            "ciudad_id": "Luque"
        },
        # Calle y numero de casa del destinatario. Obligatorios en el XML.
        "partner_street": "Av. Mariscal Lopez 1234",
        "partner_numero_casa": "1234",

        # --- Punto de salida ---
        # warehouse_data crea o reutiliza el almacen por nombre.
        "warehouse_data": {
            "name": "Almacen Principal",
            "code": "MAIN",
            "partner_street": "Av. Eusebio Ayala 1234",
            "partner_numero_casa": "1234",
            "partner_departamento": "Central",
            "partner_distrito": "Luque",
            "partner_ciudad": "Luque",
            "partner_barrio": "Centro",
            "location_direccion": "Av. Eusebio Ayala 1234",
            "location_numero_casa": "1234",
            "location_departamento": "Central",
            "location_distrito": "Luque",
            "location_ciudad": "Luque"
        },

        # --- Secuencia NRE ---
        # El prefijo identifica la secuencia DE de remision, configurada en
        # Facturacion > Configuracion > DE > Secuencias.
        # Alternativa: "secuencia_id" con el ID numerico.
        "prefijo": "002-001-",

        # --- Datos del traslado ---
        "tipo_operacion": "1",            # 1=B2B
        "motivo_nota_remision": "1",      # 1=Traslado por venta
        "responsable_emision": "1",       # 1=Emisor de la factura
        "distancia_estimada": 25,         # km estimados
        "tipo_transporte": "1",           # 1=Propio
        "modalidad_transporte": "1",      # 1=Terrestre
        "responsable_costo_flete": "1",   # 1=Emisor FE
        "inicio_estimado_traslado": "2026-05-05",
        "fin_estimado_traslado": "2026-05-06",

        # Con motivo "1" (traslado por venta) el DE exige la fecha de la
        # factura futura, salvo que el pedido ya tenga factura emitida.
        "fecha_factura_futura": "2026-05-10",

        # --- Transportista ---
        # El sistema crea o reutiliza vehiculo, chofer y empresa
        # transportista segun los datos provistos.
        "carrier_data": {
            "nombre_transportista": "Transportes XYZ S.A.",
            "marca_vehiculo": "Toyota",
            "categoria_vehiculo": "Camion",
            "matricula_vehiculo": "ABC-123",
            "tipo_documento_vehiculo": "2",    # 2=Nro de matricula
            "nombre_chofer": "Juan Perez",
            "tipo_documento_chofer": "1",       # 1=CI paraguaya
            "numero_documento_chofer": "4567890",
            # Direccion del chofer: va en el XML del DE. Si el chofer todavia
            # no existe en Element, sin este dato el DE no se puede generar.
            "street_chofer": "Av. Mariscal Estigarribia 456",
            "street_transportista": "Av. Espana 999",
            # Empresa transportista contribuyente:
            "contribuyente_transportista": True,
            "ruc_transportista": "80999888-7"
        },

        # --- Lineas a trasladar ---
        "lines": [{
            "product_id": "20458",
            "api_product_data": {
                "name": "Mercaderia general",
                "default_code": "SRV-2045",
                "uom_id": 1,        # Unidad de medida
                "tax_id": 1
            },
            "quantity": 5
        }]
    }
)
# La respuesta incluye id, name (numero NRE), DE_estado, DE_id (CDC),
# DE_xml y DE_url cuando fue aprobada por SIFEN.
print(resp.json())

const resp = await fetch(`${URL}/api/fe/remision`, {
    method: "POST",
    headers,
    body: JSON.stringify({
        // --- Cliente destinatario ---
        // ID externo. Si ya existe el partner mapeado se reutiliza; en caso
        // contrario se crea con los datos de api_partner_data.
        partner_id: "48214",
        api_partner_data: {
            name: "Distribuidora ABC S.A.",
            ruc: "80123456-7",       // RUC con digito verificador
            company_type: 2,         // 2=empresa, 1=persona
            email: "[email protected]",
            // Datos geograficos: aceptan ID numerico o nombre en texto.
            // La API resuelve los IDs segun la jerarquia SIFEN.
            departamento_id: "Central",
            distrito_id: "Luque",
            ciudad_id: "Luque"
        },
        // Calle y numero de casa del destinatario. Obligatorios en el XML.
        partner_street: "Av. Mariscal Lopez 1234",
        partner_numero_casa: "1234",

        // --- Punto de salida ---
        // warehouse_data crea o reutiliza el almacen por nombre.
        warehouse_data: {
            name: "Almacen Principal",
            code: "MAIN",
            partner_street: "Av. Eusebio Ayala 1234",
            partner_numero_casa: "1234",
            partner_departamento: "Central",
            partner_distrito: "Luque",
            partner_ciudad: "Luque",
            partner_barrio: "Centro",
            location_direccion: "Av. Eusebio Ayala 1234",
            location_numero_casa: "1234",
            location_departamento: "Central",
            location_distrito: "Luque",
            location_ciudad: "Luque"
        },

        // --- Secuencia NRE ---
        // El prefijo identifica la secuencia DE de remision, configurada en
        // Facturacion > Configuracion > DE > Secuencias.
        // Alternativa: "secuencia_id" con el ID numerico.
        prefijo: "002-001-",

        // --- Datos del traslado ---
        tipo_operacion: "1",            // 1=B2B
        motivo_nota_remision: "1",      // 1=Traslado por venta
        responsable_emision: "1",       // 1=Emisor de la factura
        distancia_estimada: 25,         // km estimados
        tipo_transporte: "1",           // 1=Propio
        modalidad_transporte: "1",      // 1=Terrestre
        responsable_costo_flete: "1",   // 1=Emisor FE
        inicio_estimado_traslado: "2026-05-05",
        fin_estimado_traslado: "2026-05-06",

        // Con motivo "1" (traslado por venta) el DE exige la fecha de la
        // factura futura, salvo que el pedido ya tenga factura emitida.
        fecha_factura_futura: "2026-05-10",

        // --- Transportista ---
        // El sistema crea o reutiliza vehiculo, chofer y empresa
        // transportista segun los datos provistos.
        carrier_data: {
            nombre_transportista: "Transportes XYZ S.A.",
            marca_vehiculo: "Toyota",
            categoria_vehiculo: "Camion",
            matricula_vehiculo: "ABC-123",
            tipo_documento_vehiculo: "2",    // 2=Nro de matricula
            nombre_chofer: "Juan Perez",
            tipo_documento_chofer: "1",       // 1=CI paraguaya
            numero_documento_chofer: "4567890",
            // Direccion del chofer: va en el XML del DE. Si el chofer todavia
            // no existe en Element, sin este dato el DE no se puede generar.
            street_chofer: "Av. Mariscal Estigarribia 456",
            street_transportista: "Av. Espana 999",
            // Empresa transportista contribuyente:
            contribuyente_transportista: true,
            ruc_transportista: "80999888-7"
        },

        // --- Lineas a trasladar ---
        lines: [{
            product_id: "20458",
            api_product_data: {
                name: "Mercaderia general",
                default_code: "SRV-2045",
                uom_id: 1,        // Unidad de medida
                tax_id: 1
            },
            quantity: 5
        }]
    })
});
// La respuesta incluye id, name (numero NRE), DE_estado, DE_id (CDC),
// DE_xml y DE_url cuando fue aprobada por SIFEN.
console.log(await resp.json());

var resp = await http.PostAsync($"{URL}/api/fe/remision", Json(new
{
    // --- Cliente destinatario ---
    // ID externo. Si ya existe el partner mapeado se reutiliza; en caso
    // contrario se crea con los datos de api_partner_data.
    partner_id = "48214",
    api_partner_data = new
    {
        name = "Distribuidora ABC S.A.",
        ruc = "80123456-7",       // RUC con digito verificador
        company_type = 2,         // 2=empresa, 1=persona
        email = "[email protected]",
        // Datos geograficos: aceptan ID numerico o nombre en texto.
        // La API resuelve los IDs segun la jerarquia SIFEN.
        departamento_id = "Central",
        distrito_id = "Luque",
        ciudad_id = "Luque"
    },
    // Calle y numero de casa del destinatario. Obligatorios en el XML.
    partner_street = "Av. Mariscal Lopez 1234",
    partner_numero_casa = "1234",

    // --- Punto de salida ---
    // warehouse_data crea o reutiliza el almacen por nombre.
    warehouse_data = new
    {
        name = "Almacen Principal",
        code = "MAIN",
        partner_street = "Av. Eusebio Ayala 1234",
        partner_numero_casa = "1234",
        partner_departamento = "Central",
        partner_distrito = "Luque",
        partner_ciudad = "Luque",
        partner_barrio = "Centro",
        location_direccion = "Av. Eusebio Ayala 1234",
        location_numero_casa = "1234",
        location_departamento = "Central",
        location_distrito = "Luque",
        location_ciudad = "Luque"
    },

    // --- Secuencia NRE ---
    // El prefijo identifica la secuencia DE de remision, configurada en
    // Facturacion > Configuracion > DE > Secuencias.
    // Alternativa: "secuencia_id" con el ID numerico.
    prefijo = "002-001-",

    // --- Datos del traslado ---
    tipo_operacion = "1",            // 1=B2B
    motivo_nota_remision = "1",      // 1=Traslado por venta
    responsable_emision = "1",       // 1=Emisor de la factura
    distancia_estimada = 25,         // km estimados
    tipo_transporte = "1",           // 1=Propio
    modalidad_transporte = "1",      // 1=Terrestre
    responsable_costo_flete = "1",   // 1=Emisor FE
    inicio_estimado_traslado = "2026-05-05",
    fin_estimado_traslado = "2026-05-06",

    // Con motivo "1" (traslado por venta) el DE exige la fecha de la
    // factura futura, salvo que el pedido ya tenga factura emitida.
    fecha_factura_futura = "2026-05-10",

    // --- Transportista ---
    // El sistema crea o reutiliza vehiculo, chofer y empresa
    // transportista segun los datos provistos.
    carrier_data = new
    {
        nombre_transportista = "Transportes XYZ S.A.",
        marca_vehiculo = "Toyota",
        categoria_vehiculo = "Camion",
        matricula_vehiculo = "ABC-123",
        tipo_documento_vehiculo = "2",    // 2=Nro de matricula
        nombre_chofer = "Juan Perez",
        tipo_documento_chofer = "1",       // 1=CI paraguaya
        numero_documento_chofer = "4567890",
        // Direccion del chofer: va en el XML del DE. Si el chofer todavia
        // no existe en Element, sin este dato el DE no se puede generar.
        street_chofer = "Av. Mariscal Estigarribia 456",
        street_transportista = "Av. Espana 999",
        // Empresa transportista contribuyente:
        contribuyente_transportista = true,
        ruc_transportista = "80999888-7"
    },

    // --- Lineas a trasladar ---
    lines = new[]
    {
        new
        {
            product_id = "20458",
            api_product_data = new
            {
                name = "Mercaderia general",
                default_code = "SRV-2045",
                uom_id = 1,        // Unidad de medida
                tax_id = 1
            },
            quantity = 5
        }
    }
}));
// La respuesta incluye id, name (numero NRE), DE_estado, DE_id (CDC),
// DE_xml y DE_url cuando fue aprobada por SIFEN.
Console.WriteLine(await resp.Content.ReadAsStringAsync());

// Campos del traslado:
//   partner_id / api_partner_data  cliente destinatario. Si ya existe el
//       partner mapeado se reutiliza. Los campos geograficos aceptan ID
//       numerico o nombre; la API resuelve los IDs segun la jerarquia SIFEN.
//   partner_street, partner_numero_casa  obligatorios en el XML del DE.
//   warehouse_data  punto de salida; crea o reutiliza el almacen por nombre.
//   prefijo  identifica la secuencia DE de remision (Facturacion >
//       Configuracion > DE > Secuencias). Alternativa: secuencia_id.
//   fecha_factura_futura  con motivo "1" (traslado por venta) el DE la
//       exige, salvo que el pedido ya tenga factura emitida.
//   carrier_data  crea o reutiliza vehiculo, chofer y empresa transportista.
//       street_chofer va en el XML del DE: sin el, un chofer que todavia no
//       existe en Element no se puede dar de alta.
String remision = """
        {
          "partner_id": "48214",
          "api_partner_data": {
            "name": "Distribuidora ABC S.A.",
            "ruc": "80123456-7",
            "company_type": 2,
            "email": "[email protected]",
            "departamento_id": "Central",
            "distrito_id": "Luque",
            "ciudad_id": "Luque"
          },
          "partner_street": "Av. Mariscal Lopez 1234",
          "partner_numero_casa": "1234",
          "warehouse_data": {
            "name": "Almacen Principal",
            "code": "MAIN",
            "partner_street": "Av. Eusebio Ayala 1234",
            "partner_numero_casa": "1234",
            "partner_departamento": "Central",
            "partner_distrito": "Luque",
            "partner_ciudad": "Luque",
            "partner_barrio": "Centro",
            "location_direccion": "Av. Eusebio Ayala 1234",
            "location_numero_casa": "1234",
            "location_departamento": "Central",
            "location_distrito": "Luque",
            "location_ciudad": "Luque"
          },
          "prefijo": "002-001-",
          "tipo_operacion": "1",
          "motivo_nota_remision": "1",
          "responsable_emision": "1",
          "distancia_estimada": 25,
          "tipo_transporte": "1",
          "modalidad_transporte": "1",
          "responsable_costo_flete": "1",
          "inicio_estimado_traslado": "2026-05-05",
          "fin_estimado_traslado": "2026-05-06",
          "fecha_factura_futura": "2026-05-10",
          "carrier_data": {
            "nombre_transportista": "Transportes XYZ S.A.",
            "marca_vehiculo": "Toyota",
            "categoria_vehiculo": "Camion",
            "matricula_vehiculo": "ABC-123",
            "tipo_documento_vehiculo": "2",
            "nombre_chofer": "Juan Perez",
            "tipo_documento_chofer": "1",
            "numero_documento_chofer": "4567890",
            "street_chofer": "Av. Mariscal Estigarribia 456",
            "street_transportista": "Av. Espana 999",
            "contribuyente_transportista": true,
            "ruc_transportista": "80999888-7"
          },
          "lines": [{
            "product_id": "20458",
            "api_product_data": {
              "name": "Mercaderia general",
              "default_code": "SRV-2045",
              "uom_id": 1,
              "tax_id": 1
            },
            "quantity": 5
          }]
        }
        """;

HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/remision")
                .POST(HttpRequest.BodyPublishers.ofString(remision))
                .build(),
        HttpResponse.BodyHandlers.ofString());
// La respuesta incluye id, name (numero NRE), DE_estado, DE_id (CDC),
// DE_xml y DE_url cuando fue aprobada por SIFEN.
System.out.println(resp.body());

# Campos del traslado:
#   partner_id / api_partner_data  cliente destinatario. Si ya existe el
#       partner mapeado se reutiliza. Los campos geograficos aceptan ID
#       numerico o nombre; la API resuelve los IDs segun la jerarquia SIFEN.
#   partner_street, partner_numero_casa  obligatorios en el XML del DE.
#   warehouse_data  punto de salida; crea o reutiliza el almacen por nombre.
#   prefijo  identifica la secuencia DE de remision (Facturacion >
#       Configuracion > DE > Secuencias). Alternativa: secuencia_id.
#   fecha_factura_futura  con motivo "1" (traslado por venta) el DE la
#       exige, salvo que el pedido ya tenga factura emitida.
#   carrier_data  crea o reutiliza vehiculo, chofer y empresa transportista.
#       street_chofer va en el XML del DE: sin el, un chofer que todavia no
#       existe en Element no se puede dar de alta.
curl -s -b cookies.txt -X POST "$URL/api/fe/remision" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  -H "Content-Type: application/json" \
  -d '{
    "partner_id": "48214",
    "api_partner_data": {
      "name": "Distribuidora ABC S.A.",
      "ruc": "80123456-7",
      "company_type": 2,
      "email": "[email protected]",
      "departamento_id": "Central",
      "distrito_id": "Luque",
      "ciudad_id": "Luque"
    },
    "partner_street": "Av. Mariscal Lopez 1234",
    "partner_numero_casa": "1234",
    "warehouse_data": {
      "name": "Almacen Principal",
      "code": "MAIN",
      "partner_street": "Av. Eusebio Ayala 1234",
      "partner_numero_casa": "1234",
      "partner_departamento": "Central",
      "partner_distrito": "Luque",
      "partner_ciudad": "Luque",
      "partner_barrio": "Centro",
      "location_direccion": "Av. Eusebio Ayala 1234",
      "location_numero_casa": "1234",
      "location_departamento": "Central",
      "location_distrito": "Luque",
      "location_ciudad": "Luque"
    },
    "prefijo": "002-001-",
    "tipo_operacion": "1",
    "motivo_nota_remision": "1",
    "responsable_emision": "1",
    "distancia_estimada": 25,
    "tipo_transporte": "1",
    "modalidad_transporte": "1",
    "responsable_costo_flete": "1",
    "inicio_estimado_traslado": "2026-05-05",
    "fin_estimado_traslado": "2026-05-06",
    "fecha_factura_futura": "2026-05-10",
    "carrier_data": {
      "nombre_transportista": "Transportes XYZ S.A.",
      "marca_vehiculo": "Toyota",
      "categoria_vehiculo": "Camion",
      "matricula_vehiculo": "ABC-123",
      "tipo_documento_vehiculo": "2",
      "nombre_chofer": "Juan Perez",
      "tipo_documento_chofer": "1",
      "numero_documento_chofer": "4567890",
      "street_chofer": "Av. Mariscal Estigarribia 456",
      "street_transportista": "Av. Espana 999",
      "contribuyente_transportista": true,
      "ruc_transportista": "80999888-7"
    },
    "lines": [{
      "product_id": "20458",
      "api_product_data": {
        "name": "Mercaderia general",
        "default_code": "SRV-2045",
        "uom_id": 1,
        "tax_id": 1
      },
      "quantity": 5
    }]
  }'

# Busca una NRE por su numero (campo "name" del stock.picking).
# Devuelve 404 NOT_FOUND si no existe.
resp = session.get(
    f"{URL}/api/fe/remision/002-001-0000123",
    headers=headers
)
data = resp.json()["data"]
print(data["DE_estado"])   # pendiente, aprobado, rechazado, cancelado
print(data["DE_id"])       # CDC de 44 digitos

// Busca una NRE por su numero (campo "name" del stock.picking).
// Devuelve 404 NOT_FOUND si no existe.
const resp = await fetch(`${URL}/api/fe/remision/002-001-0000123`, { headers });
const { data } = await resp.json();
console.log(data.DE_estado);   // pendiente, aprobado, rechazado, cancelado
console.log(data.DE_id);       // CDC de 44 digitos

using System.Text.Json.Nodes;
// Busca una NRE por su numero (campo "name" del stock.picking).
// Devuelve 404 NOT_FOUND si no existe.
var resp = await http.GetAsync($"{URL}/api/fe/remision/002-001-0000123");
var data = JsonNode.Parse(await resp.Content.ReadAsStringAsync())!["data"]!;
Console.WriteLine(data["DE_estado"]);   // pendiente, aprobado, rechazado, cancelado
Console.WriteLine(data["DE_id"]);       // CDC de 44 digitos

// Busca una NRE por su numero (campo "name" del stock.picking).
// Devuelve 404 NOT_FOUND si no existe. La respuesta trae DE_estado
// (pendiente, aprobado, rechazado, cancelado) y DE_id (CDC de 44 digitos).
HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/remision/002-001-0000123").GET().build(),
        HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

# Busca una NRE por su numero (campo "name" del stock.picking).
# Devuelve 404 NOT_FOUND si no existe. La respuesta trae DE_estado
# (pendiente, aprobado, rechazado, cancelado) y DE_id (CDC de 44 digitos).
curl -s -b cookies.txt "$URL/api/fe/remision/002-001-0000123" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB"

# Cancela una NRE ya aprobada por SIFEN: DE_estado debe ser "aprobado".
# El motivo debe tener al menos 5 caracteres (recomendado 10-200).
resp = session.post(
    f"{URL}/api/fe/remision/002-001-0000123/cancel",
    headers=headers,
    json={"motivo": "El cliente cancelo el pedido antes del despacho"}
)
# En la respuesta DE_estado pasa a "cancelado".
print(resp.json())

// Cancela una NRE ya aprobada por SIFEN: DE_estado debe ser "aprobado".
// El motivo debe tener al menos 5 caracteres (recomendado 10-200).
const resp = await fetch(`${URL}/api/fe/remision/002-001-0000123/cancel`, {
    method: "POST",
    headers,
    body: JSON.stringify({ motivo: "El cliente cancelo el pedido antes del despacho" })
});
// En la respuesta DE_estado pasa a "cancelado".
console.log(await resp.json());

// Cancela una NRE ya aprobada por SIFEN: DE_estado debe ser "aprobado".
// El motivo debe tener al menos 5 caracteres (recomendado 10-200).
var resp = await http.PostAsync($"{URL}/api/fe/remision/002-001-0000123/cancel", Json(new
{
    motivo = "El cliente cancelo el pedido antes del despacho"
}));
// En la respuesta DE_estado pasa a "cancelado".
Console.WriteLine(await resp.Content.ReadAsStringAsync());

// Cancela una NRE ya aprobada por SIFEN: DE_estado debe ser "aprobado".
// El motivo debe tener al menos 5 caracteres (recomendado 10-200).
String cancelacion = """
        {"motivo": "El cliente cancelo el pedido antes del despacho"}
        """;

HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/remision/002-001-0000123/cancel")
                .POST(HttpRequest.BodyPublishers.ofString(cancelacion))
                .build(),
        HttpResponse.BodyHandlers.ofString());
// En la respuesta DE_estado pasa a "cancelado".
System.out.println(resp.body());

# Cancela una NRE ya aprobada por SIFEN: DE_estado debe ser "aprobado".
# El motivo debe tener al menos 5 caracteres (recomendado 10-200).
curl -s -b cookies.txt -X POST "$URL/api/fe/remision/002-001-0000123/cancel" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  -H "Content-Type: application/json" \
  -d '{"motivo": "El cliente cancelo el pedido antes del despacho"}'

# El picking_id es el campo "id" que devuelve crear o buscar la NRE:
# es el ID numerico, no el numero del documento.
picking_id = 456
resp = session.post(
    f"{URL}/api/fe/remision/{picking_id}/send-email",
    headers=headers,
    json={"email": "[email protected]"}
)
# La respuesta confirma email_to, remision_name y mail_state.
# Requiere servidor de correo configurado en los ajustes DE.
print(resp.json())

// El picking_id es el campo "id" que devuelve crear o buscar la NRE:
// es el ID numerico, no el numero del documento.
const picking_id = 456;
const resp = await fetch(`${URL}/api/fe/remision/${picking_id}/send-email`, {
    method: "POST",
    headers,
    body: JSON.stringify({ email: "[email protected]" })
});
// La respuesta confirma email_to, remision_name y mail_state.
// Requiere servidor de correo configurado en los ajustes DE.
console.log(await resp.json());

// El picking_id es el campo "id" que devuelve crear o buscar la NRE:
// es el ID numerico, no el numero del documento.
var picking_id = 456;
var resp = await http.PostAsync($"{URL}/api/fe/remision/{picking_id}/send-email", Json(new
{
    email = "[email protected]"
}));
// La respuesta confirma email_to, remision_name y mail_state.
// Requiere servidor de correo configurado en los ajustes DE.
Console.WriteLine(await resp.Content.ReadAsStringAsync());

// El picking_id es el campo "id" que devuelve crear o buscar la NRE:
// es el ID numerico, no el numero del documento.
int picking_id = 456;
String correo = """
        {"email": "[email protected]"}
        """;

HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/remision/" + picking_id + "/send-email")
                .POST(HttpRequest.BodyPublishers.ofString(correo))
                .build(),
        HttpResponse.BodyHandlers.ofString());
// La respuesta confirma email_to, remision_name y mail_state.
// Requiere servidor de correo configurado en los ajustes DE.
System.out.println(resp.body());

# El picking_id de la URL es el campo "id" que devuelve crear o buscar la
# NRE: es el ID numerico, no el numero del documento.
# La respuesta confirma email_to, remision_name y mail_state.
# Requiere servidor de correo configurado en los ajustes DE.
curl -s -b cookies.txt -X POST "$URL/api/fe/remision/456/send-email" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

resp = session.post(
    f"{URL}/api/fe/partner/by-ruc/80000001-1",
    headers=headers
)
result = resp.json()
print(result["created"])       # true si se creo un contacto nuevo
print(result["data"]["id"])    # ID de Element ERP para usar en otras llamadas

const resp = await fetch(`${URL}/api/fe/partner/by-ruc/80000001-1`, {
    method: "POST",
    headers
});
const result = await resp.json();
console.log(result.created);   // true si se creo un contacto nuevo
console.log(result.data.id);   // ID de Element ERP para usar en otras llamadas

using System.Text.Json.Nodes;

var resp = await http.PostAsync($"{URL}/api/fe/partner/by-ruc/80000001-1", null);
var result = JsonNode.Parse(await resp.Content.ReadAsStringAsync())!;
Console.WriteLine(result["created"]);      // true si se creo un contacto nuevo
Console.WriteLine(result["data"]!["id"]);  // ID de Element ERP para otras llamadas

// Este endpoint no lleva cuerpo. La respuesta trae "created" (true si se
// creo un contacto nuevo) y "data.id", el ID de Element ERP que se usa
// en las demas llamadas.
HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/partner/by-ruc/80000001-1")
                .POST(HttpRequest.BodyPublishers.noBody())
                .build(),
        HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

# Este endpoint no lleva cuerpo. La respuesta trae "created" (true si se
# creo un contacto nuevo) y "data.id", el ID de Element ERP que se usa
# en las demas llamadas.
curl -s -b cookies.txt -X POST "$URL/api/fe/partner/by-ruc/80000001-1" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB"

{
    "success": true,
    "created": true,
    "data": {
        "id": 123,
        "name": "EMPRESA EJEMPLO S.A.",
        "ruc": "80000001-1",
        "ruc_state": "ACT",
        "contribuyente": true,
        "company_type": "company"
    }
}

resp = session.post(
    f"{URL}/api/fe/partner/by-ruc/80000001-1/update",
    headers=headers,
    json={"api_ruc": "80000001-1"}
)
print(resp.json())

const resp = await fetch(`${URL}/api/fe/partner/by-ruc/80000001-1/update`, {
    method: "POST",
    headers,
    body: JSON.stringify({ api_ruc: "80000001-1" })
});
console.log(await resp.json());

var resp = await http.PostAsync($"{URL}/api/fe/partner/by-ruc/80000001-1/update", Json(new
{
    api_ruc = "80000001-1"
}));
Console.WriteLine(await resp.Content.ReadAsStringAsync());

String cuerpo = """
        {"api_ruc": "80000001-1"}
        """;

HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/partner/by-ruc/80000001-1/update")
                .POST(HttpRequest.BodyPublishers.ofString(cuerpo))
                .build(),
        HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

curl -s -b cookies.txt -X POST "$URL/api/fe/partner/by-ruc/80000001-1/update" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  -H "Content-Type: application/json" \
  -d '{"api_ruc": "80000001-1"}'

resp = session.post(
    f"{URL}/api/fe/partner/by-ruc/80000001-1/update",
    headers=headers,
    json={"external_id": "48213"}
)
print(resp.json())

const resp = await fetch(`${URL}/api/fe/partner/by-ruc/80000001-1/update`, {
    method: "POST",
    headers,
    body: JSON.stringify({ external_id: "48213" })
});
console.log(await resp.json());

var resp = await http.PostAsync($"{URL}/api/fe/partner/by-ruc/80000001-1/update", Json(new
{
    external_id = "48213"
}));
Console.WriteLine(await resp.Content.ReadAsStringAsync());

String cuerpo = """
        {"external_id": "48213"}
        """;

HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/partner/by-ruc/80000001-1/update")
                .POST(HttpRequest.BodyPublishers.ofString(cuerpo))
                .build(),
        HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

curl -s -b cookies.txt -X POST "$URL/api/fe/partner/by-ruc/80000001-1/update" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  -H "Content-Type: application/json" \
  -d '{"external_id": "48213"}'

"email_cc": {
    "factura": ["[email protected]", "[email protected]"],
    "nota_credito": ["[email protected]"],
    "nota_debito": []
}

resp = session.post(
    f"{URL}/api/fe/partner/by-ruc/80000001-1/update",
    headers=headers,
    json={
        "email": "[email protected]",
        "phone": "021445566",
        "email_cc": {
            "factura": ["[email protected]", "[email protected]"]
        }
    }
)
print(resp.json())

const resp = await fetch(`${URL}/api/fe/partner/by-ruc/80000001-1/update`, {
    method: "POST",
    headers,
    body: JSON.stringify({
        email: "[email protected]",
        phone: "021445566",
        email_cc: {
            factura: ["[email protected]", "[email protected]"]
        }
    })
});
console.log(await resp.json());

var resp = await http.PostAsync($"{URL}/api/fe/partner/by-ruc/80000001-1/update", Json(new
{
    email = "[email protected]",
    phone = "021445566",
    email_cc = new
    {
        factura = new[] { "[email protected]", "[email protected]" }
    }
}));
Console.WriteLine(await resp.Content.ReadAsStringAsync());

String cuerpo = """
        {
          "email": "[email protected]",
          "phone": "021445566",
          "email_cc": {
            "factura": ["[email protected]", "[email protected]"]
          }
        }
        """;

HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/partner/by-ruc/80000001-1/update")
                .POST(HttpRequest.BodyPublishers.ofString(cuerpo))
                .build(),
        HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

curl -s -b cookies.txt -X POST "$URL/api/fe/partner/by-ruc/80000001-1/update" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "phone": "021445566",
    "email_cc": {
      "factura": ["[email protected]", "[email protected]"]
    }
  }'

{
    "success": true,
    "data": {
        "matched_count": 1,
        "updated": [
            {
                "id": 123,
                "name": "EMPRESA EJEMPLO S.A.",
                "ruc": "80000001-1",
                "email": "[email protected]"
            }
        ]
    }
}

# Paso 1: obtener el CDC buscando la factura por numero.
resp = session.get(
    f"{URL}/api/fe/invoice/001-001-0004707",
    headers=headers
)
de_id = resp.json()["data"]["DE_id"]   # CDC de 44 digitos

# Paso 2: descargar el KUDE en PDF. Este endpoint devuelve el binario,
# no JSON: hay que escribir resp.content a un archivo.
resp = session.get(
    f"{URL}/api/fe/invoice/{de_id}/kude-pdf",
    headers=headers
)
with open("kude.pdf", "wb") as f:
    f.write(resp.content)

import { writeFile } from "node:fs/promises";

// Paso 1: obtener el CDC buscando la factura por numero.
let resp = await fetch(`${URL}/api/fe/invoice/001-001-0004707`, { headers });
const { data } = await resp.json();
const deId = data.DE_id;   // CDC de 44 digitos

// Paso 2: descargar el KUDE en PDF. Este endpoint devuelve el binario,
// no JSON: se escribe el arrayBuffer a un archivo.
resp = await fetch(`${URL}/api/fe/invoice/${deId}/kude-pdf`, { headers });
await writeFile("kude.pdf", Buffer.from(await resp.arrayBuffer()));

using System.Text.Json.Nodes;

// Paso 1: obtener el CDC buscando la factura por numero.
var resp = await http.GetAsync($"{URL}/api/fe/invoice/001-001-0004707");
var deId = JsonNode.Parse(await resp.Content.ReadAsStringAsync())!["data"]!["DE_id"]!
    .GetValue<string>();   // CDC de 44 digitos

// Paso 2: descargar el KUDE en PDF. Este endpoint devuelve el binario,
// no JSON: se escriben los bytes a un archivo.
resp = await http.GetAsync($"{URL}/api/fe/invoice/{deId}/kude-pdf");
await File.WriteAllBytesAsync("kude.pdf", await resp.Content.ReadAsByteArrayAsync());

import java.nio.file.Path;

// Paso 1: obtener el CDC buscando la factura por numero.
HttpResponse<String> resp = http.send(
        pedido.apply("/api/fe/invoice/001-001-0004707").GET().build(),
        HttpResponse.BodyHandlers.ofString());
// CDC de 44 digitos dentro de "data"
String deId = resp.body().replaceAll("(?s).*\"DE_id\":\\s*\"([^\"]*)\".*", "$1");

// Paso 2: descargar el KUDE en PDF. Este endpoint devuelve el binario,
// no JSON: se guarda directo a un archivo.
http.send(pedido.apply("/api/fe/invoice/" + deId + "/kude-pdf").GET().build(),
        HttpResponse.BodyHandlers.ofFile(Path.of("kude.pdf")));

# Paso 1: obtener el CDC buscando la factura por numero.
curl -s -b cookies.txt "$URL/api/fe/invoice/001-001-0004707" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB"
# La respuesta incluye: "DE_id": "01800000011001001000000012024010112345678901"

# Paso 2: descargar el KUDE en PDF. Este endpoint devuelve el binario.
curl -s -b cookies.txt \
  "$URL/api/fe/invoice/01800000011001001000000012024010112345678901/kude-pdf" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  --output kude.pdf

# El de_id se obtiene desde GET /api/fe/remision/{numero}.
resp = session.get(
    f"{URL}/api/fe/remision/04800000011001001000000012024010112345678901/kude-pdf",
    headers=headers
)
with open("kude_remision.pdf", "wb") as f:
    f.write(resp.content)

import { writeFile } from "node:fs/promises";

// El de_id se obtiene desde GET /api/fe/remision/{numero}.
const resp = await fetch(
    `${URL}/api/fe/remision/04800000011001001000000012024010112345678901/kude-pdf`,
    { headers });
await writeFile("kude_remision.pdf", Buffer.from(await resp.arrayBuffer()));

// El de_id se obtiene desde GET /api/fe/remision/{numero}.
var resp = await http.GetAsync(
    $"{URL}/api/fe/remision/04800000011001001000000012024010112345678901/kude-pdf");
await File.WriteAllBytesAsync("kude_remision.pdf",
    await resp.Content.ReadAsByteArrayAsync());

import java.nio.file.Path;

// El de_id se obtiene desde GET /api/fe/remision/{numero}.
HttpResponse<Path> resp = http.send(
        pedido.apply("/api/fe/remision/04800000011001001000000012024010112345678901/kude-pdf")
                .GET().build(),
        HttpResponse.BodyHandlers.ofFile(Path.of("kude_remision.pdf")));
System.out.println(resp.statusCode());

# El de_id se obtiene desde GET /api/fe/remision/{numero}.
curl -s -b cookies.txt \
  "$URL/api/fe/remision/04800000011001001000000012024010112345678901/kude-pdf" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  --output kude_remision.pdf

{
    "success": true,        # Siempre true en respuestas exitosas
    "data": {
        # --- Identificacion ---
        "id": 123,                        # ID interno de Element
        "name": "001-001-0004707",        # Numero de factura

        # --- Estado contable ---
        "state": "posted",                # "draft", "posted" o "cancel"

        # --- Estado electronico (campos DE del modulo eterp_de) ---
        "DE_estado": "aprobado",          # "pendiente", "aprobado",
                                          # "rechazado" o "cancelado"
        "DE_id": "01800...",              # CDC: Codigo de Control
                                          # (44 digitos, identificador
                                          # unico del DE ante SIFEN)
        "DE_xml": "base64_encoded_xml...",# XML completo del DE en
                                          # Base64. Decodificar para
                                          # obtener el XML original.
                                          # Util para generar tickets.
        "DE_url": "https://ekuatia.set.gov.py/...",
                                          # URL de verificacion publica
        "DE_mensaje": "Aprobado",
                                          # Mensaje de respuesta SIFEN

        # --- Montos ---
        "amount_total": 150000,           # Total con impuestos
        "amount_residual": 0,             # Saldo pendiente de cobro
        "currency": "PYG",                # Codigo de moneda

        # --- Pago ---
        "payment_state": "paid",          # "not_paid", "partial",
                                          # "paid", "in_payment"
        "payment_term_id": 1,             # ID del termino de pago
        "payment_term_name": "Pago inmediato",
        "payment_term_days": 0            # Total de dias del termino.
                                          # 0 = contado, >0 = credito
    }
}

{
    "success": false,       # Siempre false en respuestas de error
    "error": {
        # Codigo de error programatico. Usar este campo para
        # manejar errores en el codigo (switch/if).
        # Ver tabla de codigos comunes mas abajo.
        "code": "CREATE_ERROR",

        # Mensaje legible describiendo el error.
        # Puede contener detalles tecnicos de Element
        # (ej: "El campo 'uom_id' con valor 99 no existe").
        "message": "Descripcion del error"
    }
}

#!/usr/bin/env python3
"""Script minimo para emitir una factura electronica via API.
Requiere: pip install requests, y la URL base, la base de datos y la
API Key de su panel de configuracion."""
import requests

URL = "https://80200001.elementtech.com.py"
API_KEY = "tu_api_key"
DB = "80200001_test"

# Element vincula la cookie de sesion con la base de datos indicada.
s = requests.Session()
s.get(f"{URL}/web", params={"db": DB})

# Al recibir el JSON el servidor valida la API Key, resuelve el cliente
# (consultando SIFEN por RUC si hace falta), resuelve o crea el producto
# por default_code, crea la factura, la publica y devuelve sus datos.
resp = s.post(
    f"{URL}/api/fe/invoice",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "X-Database": DB,
        "Content-Type": "application/json"
    },
    json={
        "partner_id": "48213",       # ID externo del cliente
        "api_ruc": "80000001-1",     # RUC para consulta SIFEN
        "lines": [{
            "product_id": "20458",
            "api_product_data": {
                "name": "Servicio",
                "default_code": "SRV-2045",
                "uom_id": 1,       # Unidad de medida (Element ID)
                "tax_id": 1        # Impuesto (Element ID)
            },
            "quantity": 1,
            "price_unit": 100000   # Precio en guaranies
        }]
    }
)

result = resp.json()
if result.get("success"):
    data = result["data"]
    print(f"Factura creada: {data['name']}")
    print(f"Estado DE: {data.get('DE_estado', 'N/A')}")
    print(f"Total: {data['amount_total']} {data['currency']}")
else:
    error = result["error"]
    print(f"Error [{error['code']}]: {error['message']}")

#!/usr/bin/env node
// Script minimo para emitir una factura electronica via API.
// Requiere Node 18 o superior, y la URL base, la base de datos y la
// API Key de su panel de configuracion.

const URL = "https://80200001.elementtech.com.py";
const API_KEY = "tu_api_key";
const DB = "80200001_test";

// Element vincula la cookie de sesion con la base de datos indicada.
const inicio = await fetch(`${URL}/web?db=${DB}`, { redirect: "manual" });
const cookie = inicio.headers.get("set-cookie")?.match(/session_id=[^;]+/)?.[0] ?? "";

// Al recibir el JSON el servidor valida la API Key, resuelve el cliente
// (consultando SIFEN por RUC si hace falta), resuelve o crea el producto
// por default_code, crea la factura, la publica y devuelve sus datos.
const resp = await fetch(`${URL}/api/fe/invoice`, {
    method: "POST",
    headers: {
        "Authorization": `Bearer ${API_KEY}`,
        "X-Database": DB,
        "Content-Type": "application/json",
        "Cookie": cookie
    },
    body: JSON.stringify({
        partner_id: "48213",       // ID externo del cliente
        api_ruc: "80000001-1",     // RUC para consulta SIFEN
        lines: [{
            product_id: "20458",
            api_product_data: {
                name: "Servicio",
                default_code: "SRV-2045",
                uom_id: 1,       // Unidad de medida (Element ID)
                tax_id: 1        // Impuesto (Element ID)
            },
            quantity: 1,
            price_unit: 100000   // Precio en guaranies
        }]
    })
});

const result = await resp.json();
if (result.success) {
    const data = result.data;
    console.log(`Factura creada: ${data.name}`);
    console.log(`Estado DE: ${data.DE_estado ?? "N/A"}`);
    console.log(`Total: ${data.amount_total} ${data.currency}`);
} else {
    console.log(`Error [${result.error.code}]: ${result.error.message}`);
}

// Script minimo para emitir una factura electronica via API.
// Requiere .NET 8 o superior, y la URL base, la base de datos y la
// API Key de su panel de configuracion.
using System.Net;
using System.Text;
using System.Text.Json;
using System.Text.Json.Nodes;

const string URL = "https://80200001.elementtech.com.py";
const string API_KEY = "tu_api_key";
const string DB = "80200001_test";

// Element vincula la cookie de sesion con la base de datos indicada.
var handler = new HttpClientHandler { CookieContainer = new CookieContainer() };
var http = new HttpClient(handler) { Timeout = TimeSpan.FromSeconds(120) };
http.DefaultRequestHeaders.Add("Authorization", $"Bearer {API_KEY}");
http.DefaultRequestHeaders.Add("X-Database", DB);
await http.GetAsync($"{URL}/web?db={DB}");

// Al recibir el JSON el servidor valida la API Key, resuelve el cliente
// (consultando SIFEN por RUC si hace falta), resuelve o crea el producto
// por default_code, crea la factura, la publica y devuelve sus datos.
var factura = new
{
    partner_id = "48213",       // ID externo del cliente
    api_ruc = "80000001-1",     // RUC para consulta SIFEN
    lines = new[]
    {
        new
        {
            product_id = "20458",
            api_product_data = new
            {
                name = "Servicio",
                default_code = "SRV-2045",
                uom_id = 1,       // Unidad de medida (Element ID)
                tax_id = 1        // Impuesto (Element ID)
            },
            quantity = 1,
            price_unit = 100000   // Precio en guaranies
        }
    }
};
var cuerpo = new StringContent(JsonSerializer.Serialize(factura), Encoding.UTF8,
    "application/json");
var resp = await http.PostAsync($"{URL}/api/fe/invoice", cuerpo);

var result = JsonNode.Parse(await resp.Content.ReadAsStringAsync())!;
if (result["success"]!.GetValue<bool>())
{
    var data = result["data"]!;
    Console.WriteLine($"Factura creada: {data["name"]}");
    Console.WriteLine($"Estado DE: {data["DE_estado"]}");
    Console.WriteLine($"Total: {data["amount_total"]} {data["currency"]}");
}
else
{
    var error = result["error"]!;
    Console.WriteLine($"Error [{error["code"]}]: {error["message"]}");
}

// Script minimo para emitir una factura electronica via API.
// Requiere Java 17 o superior, sin dependencias externas. Necesita la URL
// base, la base de datos y la API Key de su panel de configuracion.
import java.net.CookieManager;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

String URL = "https://80200001.elementtech.com.py";
String API_KEY = "tu_api_key";
String DB = "80200001_test";

// Element vincula la cookie de sesion con la base de datos indicada.
HttpClient http = HttpClient.newBuilder()
        .cookieHandler(new CookieManager())
        .connectTimeout(Duration.ofSeconds(120))
        .build();
http.send(HttpRequest.newBuilder(URI.create(URL + "/web?db=" + DB)).build(),
        HttpResponse.BodyHandlers.discarding());

// Al recibir el JSON el servidor valida la API Key, resuelve el cliente
// (consultando SIFEN por RUC si hace falta), resuelve o crea el producto
// por default_code, crea la factura, la publica y devuelve sus datos.
String factura = """
        {
          "partner_id": "48213",
          "api_ruc": "80000001-1",
          "lines": [{
            "product_id": "20458",
            "api_product_data": {
              "name": "Servicio",
              "default_code": "SRV-2045",
              "uom_id": 1,
              "tax_id": 1
            },
            "quantity": 1,
            "price_unit": 100000
          }]
        }
        """;

HttpResponse<String> resp = http.send(
        HttpRequest.newBuilder(URI.create(URL + "/api/fe/invoice"))
                .header("Authorization", "Bearer " + API_KEY)
                .header("X-Database", DB)
                .header("Content-Type", "application/json")
                .timeout(Duration.ofSeconds(120))
                .POST(HttpRequest.BodyPublishers.ofString(factura))
                .build(),
        HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

#!/usr/bin/env bash
# Script minimo para emitir una factura electronica via API.
# Necesita la URL base, la base de datos y la API Key de su panel.
set -eu

URL="https://80200001.elementtech.com.py"
API_KEY="tu_api_key"
DB="80200001_test"

# Element vincula la cookie de sesion con la base de datos indicada.
curl -s -c cookies.txt -o /dev/null "$URL/web?db=$DB"

# Al recibir el JSON el servidor valida la API Key, resuelve el cliente
# (consultando SIFEN por RUC si hace falta), resuelve o crea el producto
# por default_code, crea la factura, la publica y devuelve sus datos.
curl -s -b cookies.txt -X POST "$URL/api/fe/invoice" \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Database: $DB" \
  -H "Content-Type: application/json" \
  -d '{
    "partner_id": "48213",
    "api_ruc": "80000001-1",
    "lines": [{
      "product_id": "20458",
      "api_product_data": {
        "name": "Servicio",
        "default_code": "SRV-2045",
        "uom_id": 1,
        "tax_id": 1
      },
      "quantity": 1,
      "price_unit": 100000
    }]
  }'