Enviar detalles de las transacciones desde Braintree

Quaderno genera automáticamente tus facturas y abonos con los datos del cliente recibidos desde Braintree, que a su vez recibe la información recopilada por la plataforma que utilizas para gestionar tus ventas. Este artículo cubre cómo personalizar esos datos y está dirigido a integradores y desarrolladores.

Si falta información en tus documentos, consulta la documentación para desarrolladores de Braintree o contacta con el equipo de soporte de tu plataforma externa.

Personalizar la información de facturación del cliente

Puedes personalizar la información de facturación en tus facturas utilizando los hashes billing_address y custom_fields al crear el cliente de Braintree en tu backend.

Envía siempre los campos country e ip_address — esto facilita el cumplimiento del IVA de la UE. Para ventas B2B, envía también el tax_id de tu cliente en custom_fields.

Aquí tienes un ejemplo en Ruby:

customer = Braintree::Customer.create(
  first_name: 'Maurice',
  last_name: 'Moss',
  company: 'Reynholm Industries',
  email: '[email protected]',
  payment_method_nonce: 'nonce-from-the-client',
  credit_card: {
    billing_address: {
      street_address: '123 Carenden Road',
      locality: 'London',
      postal_code: 'EC5M 8AJ',
      country_code_alpha2: 'GB'
    }
  },
  custom_fields: {
    tax_id: 'GB184089977',
    ip_address: request.ip
  }
)

Personalizar la información de la transacción

Para transacciones puntuales, puedes especificar la descripción de la transacción con custom_fields al crear la transacción:

transaction = Braintree::Transaction.sale(
  amount: '10.00',
  payment_method_nonce: nonce_from_the_client,
  custom_fields: {
    transaction_description: 'The Neverending Story, Michael Ende (EPUB)'
  }
)

Antes de usar cualquier campo personalizado, configura el nombre del campo en tu panel de control de Braintree y mantén los valores por debajo de 255 caracteres. Al crear un campo personalizado, selecciona Store y Pass Back — Quaderno necesita que estos campos se almacenen en tu cuenta de Braintree.

Referencia de campos personalizados

Todos los campos custom_fields son opcionales. Quaderno admite los siguientes:

Campos personalizados	Descripción
`tax_id`	Número de identificación fiscal (solo para clientes)
`ip_address`	Dirección IP del cliente (solo para clientes)
`transaction_description`	Descripción de la transacción (solo para transacciones puntuales)
`additional_evidence_country`	Código del país de la evidencia en formato ISO 3166-1 alpha-2 (ES, FR, US, GB, etc.)
`additional_evidence_type`	Breve descripción de la evidencia, máximo 255 caracteres. Obligatorio cuando se aporta evidencia adicional.
`sku`	Código único del producto o servicio vendido