Última modificación: 07/09/2018
La API de SiNube expone un método POST para agregar una cuenta bancaria a un cliente existente en el catálogo, con el fin de que se puedan realizar dicha tarea desde aplicaciones externas a SiNube.
Este método POST consta de dos partes: la comunicación y el cuerpo.
COMUNICACIÓN
Primero, se proporciona una URL para establecer la comunicación con SiNube. Y para delimitar el acceso a los datos, se piden 5 parámetros:
–URL
Las URL para acceder al POST son las siguientes:
FacturaNube (Ambiente de pruebas)
http://ep-dot-facturanube.appspot.com/blob
SiNube (Ambiente de producción)
http://ep-dot-si-nube.appspot.com/blob
EL POST permite http y https; y no requiere autenticación.
–Parámetros
Se requieren 5 datos, los cuales deben estar separados entre sí por enters, codificados en una cadena BASE64 y enviados en un parámetro llamado PAR
- tipo: el valor debe ser ‘35’.
- emp: RFC de la empresa en el que se quiere agregar el producto.
- suc: Sucursal válida dentro de la empresa.
- usu: E-mail de un usuario vigente y con acceso a la empresa-sucursal.
- pwd: Contraseña de comunicaciones, esta se encuentra en Parámetros de la empresa.
Ejemplo:
Parámetros:
tipo=35[enter]
emp=AAA010101AAA[enter]
suc=Matriz[enter]
usu=usuario@gmail.com[enter]
pwd=123456789
Convertidos a BASE64:
dGlwbz0zNQplbXA9QUFBMDEwMTAxQUFBCnN1Yz1NYXRyaXoKdXN1PXVzdWFyaW9AZ21haWwuY29tCnB3ZD0xMjM0NTY3ODk=
CUERPO
El contenido o cuerpo del POST es un archivo XML que contiene los datos necesarios para generar el registro.
–XML
La estructura del Xml con los datos para agregar o actualizar producto es la siguiente:
Cliente - Diagrama
| Nodo: | ClienteBanco | Uso: | Requerido | |
|---|---|---|---|---|
| Atributo | Descripción | Uso | Tipo | Adicionales |
| sistema | Identifica el sistema o software origen desde el que se envían los datos del cliente. Sirve para delimitar las fuentes de conexión. Los sistemas que lo usen deben estar dados de alta en la lista de sistemas válidos. | Requerido | String | |
| cliente | Especifica el Id de un cliente ya existente. | Requerido | String | |
| cuenta | Especifica la cuenta bancaria a agregar del cliente | Requerido | String | |
| bancoSAT | Especifica el código del banco que le corresponde del catálogo del SAT. El valor puede estar vacío pero es necesario poner el atributo. | Requerido | String | |
| descripcionBancoExtranjero | Especifica la descripción del banco en el caso de que el bancoSAT sea 999. | Condicional | String | |
| cuentaDefault | Especifica si la cuenta bancaria será la predeterminada para los movimientos del cliente. | Requerido | String | Valor: 0 = No; 1 = Si |
| rfc | Especifica el RFC de la institución bancaria. El valor puede estar vacío pero es necesario poner el atributo. | Requerido | String |