Enviar detalles de las transacciones desde Braintree

Quaderno genera automáticamente tus facturas y abonos con los datos del cliente recibidos por Braintree, que a su vez recibe la información recopilada por la plataforma que utilizas para gestionar tus ventas.

Este artículo explica cómo personalizar la información que Braintree envía a Quaderno. Esta información es útil para integradores y desarrolladores.

Si falta información en tus documentos, consulta la documentación para desarrolladores de Braintree o ponte en contacto con el equipo de soporte de tu plataforma externa para solicitar ayuda en solucionar estos problemas.

Personalizar la información de facturación del cliente

Si deseas personalizar la información de facturación en tus facturas, puedes hacerlo utilizando los hashes billing_address y custom_fields al crear el cliente de Braintree en tu sistema backend.

Al crear un cliente en Braintree, siempre recomendamos enviar el país y la dirección IP . Esto facilitará el cumplimiento del IVA de la UE.

Para ventas B2B, también debes enviar el tax_id de tu cliente en el campo custom_fields .

En Quaderno, trabajamos con Rails, así que así es como lo haríamos 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, al crear la transacción en Braintree, también puede especificar la descripción de la transacción con custom_fields . Por ejemplo:

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, debes configurar su nombre en el panel de control de Braintree y los valores deben tener menos de 255 caracteres.

Al crear un campo personalizado, selecciona la opción Store y Passback . Quaderno necesita que estos campos se almacenen en tu cuenta de Braintree.

Campos personalizados

Todos los campos custom_fields son opcionales. Quaderno puede gestionar lo siguiente:

Campos custom_fields	Descripción
`tax_id`	Numero de identificacion fiscal (solo para clientes)
`ip_address`	Dirección IP del cliente (solo para clientes)
`transaction_description`	Descripción de la transaccion (solo para transacciones puntuales)
`additional_evidence_country`	Código del país de la evidencia en formato estándar: ISO 3166-1 alpha-2 (ES, FR, US, GB, etc.)
`additional_evidence_type`	Breve descripción (máximo 255 caracteres) de la evidencia. Campo obligatorio para evidencia adicional.
`sku`	Código único del producto o servicio vendido.