Recibos electrónicos

Un e-receipt es la versión digital de un ticket o nota de venta. Es un comprobante de pago que puedes darle a tu cliente sin solicitarle sus datos fiscales. Dicho comprobante incluye toda la información de la venta con el propósito de que pueda facturarse si el cliente lo solicita y también para incluirse dentro de una factura global.

Al crear un e-receipt en Facturapi, tus clientes tendrán acceso a un sitio web a donde podrán llenar sus datos fiscales y descargar su facuta (portal de autofactura).

También puedes crear una factura global al final del mes que incluya todos aquellos recibos que no fueron facturados.

Crear un recibo

Para ver las descripciones de todos los parámetros, consulta la referencia completa del método Crear Recibo.

Node.js

const facturapi = new Facturapi('sk_test_API_KEY');
const receipt = await facturapi.receipts.create({
  folio_number: 1234,
  payment_form: Facturapi.PaymentForm.DINERO_ELECTRONICO,
  items: [{
    quantity: 1,
    product: {
      description: 'Ukelele',
      product_key: '60131324',
      price: 345.60,
      sku: 'ABC1234'
    }
  }]
});

C#

var facturapi = new FacturapiClient("sk_test_API_KEY");
var receipt = await facturapi.Receipt.CreateAsync(new Dictionary<string, object>
{
  ["folio_number"] = 1234,
  ["payment_form"] = Facturapi.PaymentForm.DINERO_ELECTRONICO,
  ["items"] = new Dictionary<string, object>[]
  {
    new Dictionary<string, object>
    {
      ["description"] = "Ukelele",
      ["product_key"] = "60131324",
      ["price"] = 345.60,
      ["sku"] = "ABC1234"
    }
  }
});

PHP

$facturapi = new Facturapi("sk_test_API_KEY");

$receipt = $facturapi->Receipts->create([
  "folio_number" => 1234,
  "payment_form" => "03",
  "items" => [
    [
      "description" => "Ukelele",
      "product_key" => "60131324",
      "price" => 345.60,
      "sku" => "ABC1234"
    ]
  ]
]);

cURL

curl https://www.facturapi.io/v2/receipts \
  -H "Authorization: Bearer sk_test_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "folio_number": 1234,
        "payment_form": "03",
        "items": [{
          "quantity": 1,
          "product": {
            "description": "Ukelele",
            "product_key": "60131324",
            "price": 345.60,
            "sku": "ABC1234"
          }
        }]
      }'

Portal de Autofactura

Cuando creas un e-receipt, tienes la opción de enviarlo por correo electrónico a tu cliente. En el correo se incluye un enlace a un portal de autofactura donde tu cliente podrá llenar sus datos fiscales y descargar su factura.

Para más información consulta el artículo de Autofactura.

Facturar un recibo

Por medio del método Facturar Recibo puedes convertir un e-receipt en una factura. Para ello, debes enviar los datos del cliente y otros datos que no se solicitan al crear el recibo.

Node.js

const invoice = await facturapi.receipts.invoice(receipt.id, {
  customer: {
    legal_name: 'Roger Watters',
    tax_id: 'ROWA121212A11',
    email: 'roger@pinkfloyd.com'
  },
  folio_number: 914,
  series: 'F'
});

C#

var invoice = await facturapi.Receipt.InvoiceAsync(receipt.Id, new Dictionary<string, object>
{
  ["customer"] = new Dictionary<string, object>
  {
    ["legal_name"] = "Roger Watters",
    ["tax_id"] = "ROWA121212A11",
    ["email"] = "roger@pinkfloyd.com"
  },
  ["folio_number"] = 914,
  ["series"] = "F"
});

PHP

$invoice = $facturapi->Receipts->invoice($receipt->id, [
  "customer" => [
    "legal_name" => "Roger Watters",
    "tax_id" => "ROWA121212A11",
    "email" => "roger@pinkfloyd.com"
  ],
  "folio_number" => 914,
  "series" => "F"
]);

cURL

curl https://www.facturapi.io/v2/receipts/5ebd8e56f5687a013ca0df46/invoice \
  -H "Authorization: Bearer sk_test_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "customer": {
          "legal_name": "Roger Watters",
          "tax_id": "ROWA121212A11",
          "email": "roger@pinkfloyd.com"
        },
        "folio_number": 914,
        "series": "F"
    }'