Factura electrónica para WooCommerce y Shopify en Costa Rica

Por integración vía API, no por un botón mágico. El patrón es siempre el mismo: tu tienda escucha el evento de orden pagada y, cuando ocurre, dispara un POST a la API de Plaxp con los datos de la venta. Nosotros generamos el XML v4.4, lo firmamos con XAdES, lo enviamos a Hacienda y le mandamos al cliente el PDF y los XML por correo.

• Se paga una orden en tu tienda (WooCommerce, Shopify, u otra)
• La tienda dispara un POST a la API con receptor, líneas y medios de pago
• Plaxp arma el XML 4.4, lo firma y lo envía a Hacienda
• El cliente recibe su comprobante (PDF + XML) por correo
• Vos consultás el estado por la clave cuando lo necesités

Es una llamada que corrés al recibir el webhook de orden pagada de tu tienda. Mapeás los ítems de la orden a las líneas del comprobante y listo:

// Handler del webhook "order paid" de tu tienda (WooCommerce/Shopify/…)
export async function onOrderPaid(order) {
  await fetch('https://api.plaxp.com/api/procesar', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.PLAXP_API_KEY,
    },
    body: JSON.stringify({
      tipo_documento: order.customer?.taxId ? '01' : '04', // 01=FE (con datos) · 04=Tiquete
      codigo_sucursal: '001',
      codigo_caja: '001',
      consecutivo: order.number,
      condicion_venta: '01',
      medios_pago: [{ tipo: '04', monto: order.total }],    // 04 = tarjeta
      receptor: order.customer && {
        tipo_identificacion: '01',
        identificacion: order.customer.taxId,
        nombre: order.customer.name,
        correo: order.customer.email,
      },
      lineas: order.items.map((it) => ({
        codigo_cabys: it.cabys,        // el CABYS lo mapeás por producto
        detalle: it.name,
        cantidad: it.qty,
        precio_unitario: it.price,
        codigo_tarifa: '08',           // 08 = IVA 13%
        tarifa: 13,
      })),
    }),
  });
}

Cada línea necesita su código CABYS de 13 dígitos. Lo natural es guardarlo como un atributo del producto en tu tienda y mapearlo al armar la línea (como en el ejemplo). Así cada venta sale con el código correcto y evitás el rechazo -400 por CABYS inexistente —uno de los más comunes, documentado en errores de rechazo de Hacienda v4.4.

Por la API. Ahí tenés los tipos de comprobante, la autenticación (API Key u OAuth), los ejemplos en varios lenguajes y cómo consultar el estado: la documentación de la API de facturación electrónica. Y para probar sin emitir en real, la guía de sandbox (TRIBU-CR).