Enviar productores vinculados

Envía los registros de productores participantes en tanques colectivos registrados en el ERP a la Plataforma de Leche.

Método POST

http://app.milksrota.com.br/api/retaguardasync/writeVinculado

Enviar solicitud al servidor

Datos

{
    "conta_id": "DDDDD",
    "token": "XXXX-XXXX-XXXX-XXXX",
    "doc": "99.999.999/9999-99"
    "data": [
        // lista de registros de productores participantes
    ]
}

conta_id: Se debe informar el ID de cuenta que encuentra en la pantalla "Su cuenta" en el menú principal del panel de Milk's Rota.

token: Se debe informar el Token de la cuenta, el cual puedes encontrar en la pantalla "Su cuenta" en el menú principal del panel de Milk's Rota.

doc: Se debe informar el RUC de la cuenta registrada. Se puede encontrar en la pantalla "Su cuenta" en el menú principal del tablero de Milk's Rota.

data: Lista que debe contener uno o más registros de productores. Cada registro puede ser informado con la lista de propiedades que se detalla a continuación. Solo los campos obligatorios no se pueden omitir.

Propriedades

Campo	Descripción	Tipo	Obrigatório
produtor	código de productor participante.	Texto	SIM
fazenda	código de registro de la finca del productor participante	Texto	SIM
tanque	código de tanque colectivo al que se vinculará el registro	Texto	SIM
proprietário	Indica si el productor es responsable del tanque colectivo (0) - NO, (1) - SI	Texto	SIM
fornecedor	Indica si el productor es proveedor o solo participante del tanque colectivo (0) - NO, (1) - SI	Texto	SIM (Default = 1)
porcentagem	Indica el porcentaje de participación en el volumen producido para el participante. Aplicable en casos de tanques configurados para división automática por porcentaje	Decimal (10,4)	NÃO
deleted	Si se debe eliminar el registro. Si envía el valor 1, se eliminará si ya existe en la plataforma. Si se envía 0, se reactivará en la plataforma.	Texto	SIM

Ejemplo solicitud al servidor

{
    "conta_id": 999999,
    "token": "77d3-96a6-c1a3-c58e",
    "doc": "99.999.999/9999-99",
    "data": [
        {
            "tanque": "T-0001",  // Código de depósito colectivo registrado en la plataforma    
            "produtor": "000058", // Código de productor vinculado          
            "fazenda": "907010", // Código de la finca del productor
            "proprietário": "1",   // solo 1 propietario debe ser nominado para el conjunto.
            "fornecedor": "0",    // Indica que este participante no podrá recibir lanzamientos de volumen. 
            "porcentagem": null,           
            "deleted": "0"
        },
        {
            "tanque": "T-0001",
            "produtor": "000059",             
            "fazenda": "907011", 
            "proprietário": "0", 
            "fornecedor": "1", // Este participante puede recibir lanzamientos de volumen.  
            "porcentagem": null,           
            "deleted": "0"
        },
        {
            "tanque": "T-0001",
            "produtor": "000060",             
            "fazenda": "907012", 
            "proprietário": "1", 
            "fornecedor": "1",  
            "porcentagem": null,           
            "deleted": "0"
        }                   
    ]
}

La propiedad "tanque" debe contener el código del tanque previamente registrado en la plataforma y configurado como tanque colectivo ("propiedad coletivo = 1") al momento de generar el registro del tanque. Si no se ha realizado este ajuste, al recibir registros de participantes vinculados al tanque, la API ajustará automáticamente el registro de este tanque indicando que pasa a ser colectivo.

La propiedad "propietario" indica que el productor vinculado a este registro es el "responsable o cabeza" del grupo, y sólo puede contener, para cada tanque, un único registro vinculado a esta propiedad que contenga el valor (1), ya que sólo un se permite un responsable por cada tanque colectivo

La propiedad "fornecedor" indica si el tanque colectivo participante puede recibir o no lanzamientos o distribución de volumen. Si este atributo está marcado con (0) - Cero, la aplicación de cobro inhibirá el lanzamiento de volúmenes para este participante.

La propiedad "deleted" se utiliza para comandar el proceso de actualización, incluyendo o eliminando lógicamente el registro. Si su valor es "0" (cero) y no se ha encontrado el registro, se creará. Si se encuentra, el valor se actualizará y si el valor es "1" (uno), el contenido se excluirá lógicamente de la base de datos.

Respuesta

200: Importación realizada

{
  "succes": true,
    "message": "OK",
    "data": [],
    "monitor.time": 2.14737200737 // Tiempo de ejecución
}  

Los registros fueron subidos a la Plataforma de Leche e importados sin error.

200: importación fallida

{
    "succes": true,
    "message": "OK",
    "data": [ // errores de importación
        {
            "tanque": "T-0001", // Código de tanque no importado
            "error_message": "proprietário não informado", // mensaje de error
            "error_code": 40003 // código de error
        }
    ],
    "monitor.time": 2.14737200737 // Tiempo de ejecución
}

Los registros se cargaron en la Plataforma de Milk y se importaron, sin embargo, algunos registros no se pudieron importar.

404: Cuenta no encontrada

{    
    "success": false,
    "message": "Conta não localizada",
    "data": [],
    "monitor.time": 2.14737200737 // Tiempo de ejecución
}

Que significa eso? Significa que la identificación de la cuenta no se encontró en la Plataforma de Milk's.

403: Token no valido

{
    "success": false,
    "message": "Token inválido",
    "data": [],
    "monitor.time": 2.14737200737 // Tiempo de ejecución
}

Que significa eso? Significa que el token informado en la solicitud no corresponde al token registrado para la cuenta.