Última modificación: 21/12/2022
La API de SiNube expone un método POST para agregar un cliente nuevo al 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 ‘13’.
- 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=13[enter]
emp=AAA010101AAA[enter]
suc=Matriz[enter]
usu=usuario@gmail.com[enter]
pwd=123456789
Convertidos a BASE64:
dGlwbz0xMw0KZW1wPUFBQTAxMDEwMUFBQQ0Kc3VjPU1hdHJpeg0KdXN1PXVzdWFyaW9AZ21haWwuY29tDQpwd2Q9MTIzNDU2Nw==
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: | Cliente | Uso: | Requerido | |
|---|---|---|---|---|
| Atributo | Descripción | Uso | Tipo | Adicionales |
| sistema | Identifica el sistema o software origen desde el que se manda el 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 | |
| estatus | Especifica el estatus del cliente | Requerido | Integer | Valor: 0 = cliente; 1 = prospecto; 2 = inactivo |
| rfcCliente | Especifica el RFC del cliente. | Opcional | String | |
| moneda | Especifica la moneda que utilizará el cliente y debe existir en el catálogo de monedas de SiNube. | Requerido en nuevo cliente | String | |
| razonSocial | Especifica la razón social del cliente cuando sea una persona moral. | Requerido para persona moral. | String | |
| esPersonaFisica | Especifica si el cliente es una persona física o una persona moral. | Requerido en nuevo cliente | Integer | Valor: 0 = falso; 1 = verdadero |
| nombre | Especifica el nombre de la persona física. | Requerido para Persona física. | String | |
| apellidoPaterno | Especifica el apellido paterno de la persona física. | Requerido para Persona física. | String | |
| apellidomaterno | Especifica el apellido materno de la persona física. | Requerido para Persona física. | String | |
| Especifica el email del cliente | Requerido en nuevo cliente | String | ||
| cuenta | Especifica la cuenta contable asignada al cliente en contabilidad, esta cuenta debe existir en el catálogo de cuentas contables de SiNube. | Opcional | String | |
| cuentaIngreso | Especifica la cuenta contable default para ingresos que se utilizará en contabilidad, esta cuenta debe existir en el catálogo de cuentas contables de SiNube. | Opcional | String | |
| correoPropietario | Especifica el correo del vendedor que atenderá al cliente. | Requerido en nuevo cliente | String | |
| codigoAuxiliar | Especifica el código auxiliar para el cliente. | Opcional | String | |
| nombreComercial | Especifica el nombre comercial del cliente cuando es persona moral. | Opcional | String | |
| diasCredito | Especifica el número de días de crédito que se le brindara al cliente para realizar el pago. | Opcional | String | |
| referenciaBancaria | Especifica una referencia bancaria, esta referencia se utilizará en el módulo de conciliación bancaria de SiNube. | Opcional | String | |
| seDesglosaIEPS | Especifica si el cliente requiere desglosar IEPS en la factura. | Opcional | Integer | Valor: 1 = True, 0 = False |
| telefono | Especifica el número telefónico del cliente. | Opcional | String | |
| observaciones | Especifica observaciones para el cliente. | Opcional | String | |
| listaPrecios | Especifica el nombre de la lista de precios predeterminada para el cliente. Esta se utiliza en cotización, pedido, nota de venta y factura. | Opcional | String | |
| formaPago | Especifica la forma de pago predeterminada para el cliente. Esta se utiliza en cotización y factura. | Opcional | String | |
| condicionPago | Especifica la condición de pago predeterminada para el cliente. Esta se utiliza en cotización y factura. | Opcional | String | |
| metodoPago | Especifica el método de pago predeterminada para el cliente. Esta se utiliza en cotización y factura. | Opcional | String | |
| zona | Especifica la zona en que se ubica el cliente. Esta debe existir en el catálogo de zonas de SiNube. | Opcional | String | |
| clasificacion | Especifica la clasificación del cliente. Esta debe existir en el catálogo de zonas de SiNube. | Opcional | String | |
| usoCfdi | Especifica la clave del uso de CFDI predeterminado para el cliente. Se utiliza en la factura. | Opcional | String | |
| paisresidencia | Especifica la clave del país de residencia para efectos fiscales del receptor de la factura, cuando se trate de un cliente extranjero. | Requerido cuando el cliente es extranjero | String | |
| numRegId | Especifica el número de registro de identidad fiscal del receptor cuando sea residente en el extranjero. Es condicional. | Requerido cuando el cliente es extranjero | String | |
| zonaHoraria | Indica la zona horaria desde la que se graba al cliente. Es requerido para determinar el valor de los campos diaAlta y mesAlta en la base de datos. | Opcional | String | Ejemplo: El valor “-6” corresponde a la zona horaria UTC -6:00 (México Centro) |
| regimenFiscal | Indica el régimen fiscal que le corresponde al cliente. | Obligatorio para CFDI 4.0 | String | Ejemplo: El valor “601” se refiere al régimen General de Ley Personas Morales, de acuerdo al catálogo c_RegimenFiscal |
Nodo: DireccionFiscal - Diagrama
| Nodo: | DireccionFiscal | Uso: | Opcional | |
|---|---|---|---|---|
| Atributo | Descripción | Uso | Tipo | Adicionales |
| estado | Especificar la entidad federativa de la dirección fiscal. | Opcional | String | Debe existir en el catálogo de Estados en SiNube. |
| pais | Especificar el país de la dirección fiscal. | Opcional | String | Debe existir en el catálogo de Países en SiNube. |
| codigoPostal | Especifica el Código Postal de la dirección fiscal. | Opcional | String | |
| calle | Especifica la calle de la dirección fiscal. | Opcional | String | |
| noExterior | Especifica el número exterior de la dirección fiscal. | Opcional | String | |
| noInterior | Especifica el número interior de la dirección fiscal. | Opcional | String | |
| localidad | Especifica una localidad para la dirección fiscal. | Opcional | String | |
| referencia | Especifica una referencia para la dirección fiscal. | Opcional | String | |
| colonia | Especifica la colonia para la dirección fiscal. | Opcional | String | |
| municipio | Especifica el municipio o alcaldía para la dirección fiscal. | Opcional | String | Debe existir en el catálogo de Municipios en SiNube. |
Ejemplos XML
Agregar Cliente
Respuestas del POST
Sin Error:
Con Error:
